home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: LaTeX Document
(document/latex).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| LaTeX Document (document/latex)
| magic
| Supported |
| 1%
| dexvert
| Corel 10 Texture (image/corel10Texture)
| ext
| Unsupported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| LaTeX document text
| default
| |
| 99%
| file
| C source, ASCII text
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| fmt/281 LaTeX (Subdocument)
| default
| |
| 100%
| detectItEasy
| Format: Plain text[LF]
| default
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 63 68 61 70 74 65 72 | 20 7b 47 65 6e 65 72 61 |\chapter| {Genera|
|00000010| 6c 7d 0a 0a 5c 73 65 63 | 74 69 6f 6e 20 7b 4f 76 |l}..\sec|tion {Ov|
|00000020| 65 72 76 69 65 77 7d 0a | 0a 54 68 65 72 65 20 61 |erview}.|.There a|
|00000030| 72 65 20 63 65 72 74 61 | 69 6e 20 61 70 70 72 6f |re certa|in appro|
|00000040| 61 63 68 65 73 20 74 61 | 6b 65 6e 20 62 79 20 50 |aches ta|ken by P|
|00000050| 50 20 70 72 6f 63 65 73 | 73 65 73 2e 20 20 54 68 |P proces|ses. Th|
|00000060| 65 73 65 20 61 72 65 20 | 64 65 73 63 72 69 62 65 |ese are |describe|
|00000070| 64 0a 68 65 72 65 20 74 | 6f 20 66 61 63 69 6c 69 |d.here t|o facili|
|00000080| 74 61 74 65 20 65 6d 75 | 6c 61 74 69 6f 6e 20 62 |tate emu|lation b|
|00000090| 79 20 6e 65 77 20 70 72 | 6f 63 65 73 73 65 73 2e |y new pr|ocesses.|
|000000a0| 20 54 68 65 73 65 20 61 | 72 65 20 6e 6f 74 20 73 | These a|re not s|
|000000b0| 74 72 69 63 74 0a 67 75 | 69 64 65 6c 69 6e 65 73 |trict.gu|idelines|
|000000c0| 2c 20 62 75 74 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |, but fo|llowing |
|000000d0| 65 78 69 73 74 69 6e 67 | 20 70 72 61 63 74 69 73 |existing| practis|
|000000e0| 65 73 20 77 69 6c 6c 20 | 75 73 75 61 6c 6c 79 20 |es will |usually |
|000000f0| 62 65 20 65 61 73 69 65 | 72 0a 61 6e 64 20 6d 61 |be easie|r.and ma|
|00000100| 6b 65 20 75 70 67 72 61 | 64 69 6e 67 20 74 68 65 |ke upgra|ding the|
|00000110| 20 73 6f 66 74 77 61 72 | 65 20 6c 65 73 73 20 70 | softwar|e less p|
|00000120| 61 69 6e 66 75 6c 2e 0a | 0a 5c 73 65 63 74 69 6f |ainful..|.\sectio|
|00000130| 6e 20 7b 49 6e 69 74 69 | 61 6c 69 73 61 74 69 6f |n {Initi|alisatio|
|00000140| 6e 7d 0a 0a 41 6c 6c 20 | 50 50 20 70 72 6f 67 72 |n}..All |PP progr|
|00000150| 61 6d 73 20 67 65 6e 65 | 72 61 6c 6c 79 20 73 74 |ams gene|rally st|
|00000160| 61 72 74 20 62 79 20 63 | 61 6c 6c 69 6e 67 20 6f |art by c|alling o|
|00000170| 6e 65 20 6f 72 20 6d 6f | 72 65 20 69 6e 69 74 69 |ne or mo|re initi|
|00000180| 61 6c 69 73 61 74 69 6f | 6e 0a 72 6f 75 74 69 6e |alisatio|n.routin|
|00000190| 65 73 2e 20 54 68 69 73 | 20 6d 61 79 20 76 61 72 |es. This| may var|
|000001a0| 79 20 64 65 70 65 6e 64 | 69 6e 67 20 6f 6e 20 77 |y depend|ing on w|
|000001b0| 68 61 74 20 74 68 65 20 | 63 68 61 6e 6e 65 6c 20 |hat the |channel |
|000001c0| 6e 65 65 64 73 20 74 6f | 20 6b 6e 6f 77 2e 0a 54 |needs to| know..T|
|000001d0| 68 69 73 20 69 6e 69 74 | 69 61 6c 69 73 61 74 69 |his init|ialisati|
|000001e0| 6f 6e 20 64 6f 65 73 20 | 76 61 72 69 6f 75 73 20 |on does |various |
|000001f0| 74 68 69 6e 67 73 2c 20 | 61 6d 6f 6e 67 73 74 20 |things, |amongst |
|00000200| 77 68 69 63 68 20 61 72 | 65 3a 0a 5c 62 65 67 69 |which ar|e:.\begi|
|00000210| 6e 7b 69 74 65 6d 69 7a | 65 7d 0a 5c 69 74 65 6d |n{itemiz|e}.\item|
|00000220| 09 52 65 61 64 69 6e 67 | 20 67 6c 6f 62 61 6c 20 |.Reading| global |
|00000230| 70 61 72 61 6d 65 74 65 | 72 73 20 66 72 6f 6d 20 |paramete|rs from |
|00000240| 74 68 65 20 74 61 69 6c | 6f 72 20 66 69 6c 65 2e |the tail|or file.|
|00000250| 0a 5c 69 74 65 6d 09 49 | 6e 69 74 69 61 6c 69 73 |.\item.I|nitialis|
|00000260| 69 6e 67 20 74 68 65 20 | 6c 6f 67 67 69 6e 67 20 |ing the |logging |
|00000270| 70 61 63 6b 61 67 65 73 | 2e 0a 5c 69 74 65 6d 09 |packages|..\item.|
|00000280| 48 61 6e 64 6c 69 6e 67 | 20 6f 66 20 73 69 67 6e |Handling| of sign|
|00000290| 61 6c 73 2e 0a 5c 65 6e | 64 7b 69 74 65 6d 69 7a |als..\en|d{itemiz|
|000002a0| 65 7d 0a 0a 54 68 65 20 | 6e 6f 72 6d 61 6c 20 6d |e}..The |normal m|
|000002b0| 65 74 68 6f 64 20 6f 66 | 20 69 6e 69 74 69 61 6c |ethod of| initial|
|000002c0| 69 73 69 6e 67 20 61 20 | 70 72 6f 63 65 73 73 20 |ising a |process |
|000002d0| 69 73 20 74 6f 20 63 61 | 6c 6c 20 74 68 65 20 66 |is to ca|ll the f|
|000002e0| 6f 6c 6c 6f 77 69 6e 67 | 0a 72 6f 75 74 69 6e 65 |ollowing|.routine|
|000002f0| 20 76 65 72 79 20 65 61 | 72 6c 79 20 6f 6e 20 28 | very ea|rly on (|
|00000300| 75 73 75 61 6c 6c 79 20 | 6f 6e 65 20 6f 66 20 74 |usually |one of t|
|00000310| 68 65 20 66 69 72 73 74 | 20 74 68 69 6e 67 73 29 |he first| things)|
|00000320| 3a 0a 5c 62 65 67 69 6e | 7b 71 75 6f 74 65 7d 5c |:.\begin|{quote}\|
|00000330| 69 6e 64 65 78 7b 73 79 | 73 5c 5f 69 6e 69 74 7d |index{sy|s\_init}|
|00000340| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00000350| 0a 73 79 73 5f 69 6e 69 | 74 20 28 6e 61 6d 65 29 |.sys_ini|t (name)|
|00000360| 0a 63 68 61 72 20 2a 6e | 61 6d 65 3b 0a 5c 65 6e |.char *n|ame;.\en|
|00000370| 64 7b 76 65 72 62 61 74 | 69 6d 7d 5c 65 6e 64 7b |d{verbat|im}\end{|
|00000380| 71 75 6f 74 65 7d 0a 0a | 54 68 69 73 20 72 6f 75 |quote}..|This rou|
|00000390| 74 69 6e 65 20 64 6f 65 | 73 20 6d 6f 73 74 20 6f |tine doe|s most o|
|000003a0| 66 20 74 68 65 20 69 6e | 69 74 69 61 6c 69 73 61 |f the in|itialisa|
|000003b0| 74 69 6f 6e 20 72 65 71 | 75 69 72 65 64 2e 20 54 |tion req|uired. T|
|000003c0| 68 65 20 61 72 67 75 6d | 65 6e 74 20 69 73 0a 75 |he argum|ent is.u|
|000003d0| 73 75 61 6c 6c 79 20 74 | 68 65 20 76 61 6c 75 65 |sually t|he value|
|000003e0| 20 6f 66 20 5c 76 65 72 | 62 7c 61 72 67 76 5b 30 | of \ver|b|argv[0|
|000003f0| 5d 7c 2c 20 77 68 69 63 | 68 20 69 73 20 75 73 65 |]|, whic|h is use|
|00000400| 64 20 69 6e 20 74 68 65 | 20 6c 6f 67 67 69 6e 67 |d in the| logging|
|00000410| 0a 69 6e 69 74 69 61 6c | 69 73 61 74 69 6f 6e 20 |.initial|isation |
|00000420| 74 6f 20 72 65 63 6f 72 | 64 20 74 68 65 20 6e 61 |to recor|d the na|
|00000430| 6d 65 20 6f 66 20 74 68 | 69 73 20 70 72 6f 67 72 |me of th|is progr|
|00000440| 61 6d 2e 0a 0a 46 6f 72 | 20 73 6f 6d 65 20 70 72 |am...For| some pr|
|00000450| 6f 67 72 61 6d 73 20 68 | 6f 77 65 76 65 72 2c 20 |ograms h|owever, |
|00000460| 74 68 69 73 20 73 6f 72 | 74 20 6f 66 20 69 6e 69 |this sor|t of ini|
|00000470| 74 69 61 6c 69 73 61 74 | 69 6f 6e 20 69 73 20 6e |tialisat|ion is n|
|00000480| 6f 74 0a 61 70 70 72 6f | 70 72 69 61 74 65 2e 20 |ot.appro|priate. |
|00000490| 49 6e 20 74 68 69 73 20 | 63 61 73 65 20 61 6e 6f |In this |case ano|
|000004a0| 74 68 65 72 20 69 6e 74 | 65 72 66 61 63 65 20 6d |ther int|erface m|
|000004b0| 61 79 20 62 65 20 62 65 | 74 74 65 72 2e 0a 5c 62 |ay be be|tter..\b|
|000004c0| 65 67 69 6e 7b 71 75 6f | 74 65 7d 5c 69 6e 64 65 |egin{quo|te}\inde|
|000004d0| 78 7b 70 70 5c 5f 69 6e | 69 74 69 61 6c 69 73 65 |x{pp\_in|itialise|
|000004e0| 7d 5c 62 65 67 69 6e 7b | 76 65 72 62 61 74 69 6d |}\begin{|verbatim|
|000004f0| 7d 0a 69 6e 74 20 70 70 | 5f 69 6e 69 74 69 61 6c |}.int pp|_initial|
|00000500| 69 73 65 20 28 6e 61 6d | 65 2c 20 66 6c 61 67 73 |ise (nam|e, flags|
|00000510| 29 0a 63 68 61 72 20 2a | 6e 61 6d 65 3b 0a 69 6e |).char *|name;.in|
|00000520| 74 20 66 6c 61 67 73 3b | 0a 5c 65 6e 64 7b 76 65 |t flags;|.\end{ve|
|00000530| 72 62 61 74 69 6d 7d 5c | 65 6e 64 7b 71 75 6f 74 |rbatim}\|end{quot|
|00000540| 65 7d 0a 54 68 69 73 20 | 72 6f 75 74 69 6e 65 20 |e}.This |routine |
|00000550| 77 69 6c 6c 20 72 65 61 | 64 20 69 6e 20 74 68 65 |will rea|d in the|
|00000560| 20 74 61 69 6c 6f 72 20 | 66 69 6c 65 2c 20 62 75 | tailor |file, bu|
|00000570| 74 20 77 69 6c 6c 20 6f | 70 74 69 6f 6e 61 6c 6c |t will o|ptionall|
|00000580| 79 20 6e 6f 74 0a 63 6f | 6e 66 69 67 75 72 65 20 |y not.co|nfigure |
|00000590| 63 65 72 74 61 69 6e 20 | 61 73 70 65 63 74 73 20 |certain |aspects |
|000005a0| 64 65 70 65 6e 64 69 6e | 67 20 6f 6e 20 74 68 65 |dependin|g on the|
|000005b0| 20 66 6c 61 67 73 2e 20 | 54 68 65 20 6e 61 6d 65 | flags. |The name|
|000005c0| 20 69 73 20 74 68 65 20 | 73 61 6d 65 0a 61 73 20 | is the |same.as |
|000005d0| 69 6e 20 5c 76 65 72 62 | 7c 73 79 73 5f 69 6e 69 |in \verb||sys_ini|
|000005e0| 74 7c 2e 20 54 68 65 20 | 66 6c 61 67 73 20 63 61 |t|. The |flags ca|
|000005f0| 6e 20 62 65 20 61 6e 79 | 20 6f 66 20 74 68 65 20 |n be any| of the |
|00000600| 66 6f 6c 6c 6f 77 69 6e | 67 3a 0a 5c 5b 5c 62 65 |followin|g:.\[\be|
|00000610| 67 69 6e 7b 74 61 62 75 | 6c 61 72 7d 7b 7c 6c 7c |gin{tabu|lar}{|l||
|00000620| 70 7b 2e 36 5c 74 65 78 | 74 77 69 64 74 68 7d 7d |p{.6\tex|twidth}}|
|00000630| 0a 5c 68 6c 69 6e 65 0a | 09 5c 6d 75 6c 74 69 63 |.\hline.|.\multic|
|00000640| 6f 6c 75 6d 6e 7b 31 7d | 7b 7c 63 7c 7d 7b 5c 62 |olumn{1}|{|c|}{\b|
|00000650| 66 20 46 6c 61 67 7d 26 | 0a 09 09 5c 6d 75 6c 74 |f Flag}&|...\mult|
|00000660| 69 63 6f 6c 75 6d 6e 7b | 31 7d 7b 7c 63 7c 7d 7b |icolumn{|1}{|c|}{|
|00000670| 5c 62 66 20 45 66 66 65 | 63 74 7d 20 5c 5c 0a 5c |\bf Effe|ct} \\.\|
|00000680| 68 6c 69 6e 65 0a 09 5c | 74 74 20 54 41 49 5c 5f |hline..\|tt TAI\_|
|00000690| 4e 4f 4e 45 20 26 20 4e | 6f 20 73 70 65 63 69 61 |NONE & N|o specia|
|000006a0| 6c 20 74 61 69 6c 6f 72 | 69 6e 67 20 69 73 20 64 |l tailor|ing is d|
|000006b0| 6f 6e 65 2e 5c 5c 0a 09 | 5c 74 74 20 54 41 49 5c |one.\\..|\tt TAI\|
|000006c0| 5f 4c 4f 47 53 20 26 20 | 52 65 73 65 74 20 61 6c |_LOGS & |Reset al|
|000006d0| 6c 20 6c 6f 67 73 20 74 | 6f 20 75 73 65 20 74 68 |l logs t|o use th|
|000006e0| 65 20 50 50 20 6c 6f 67 | 20 64 69 72 65 63 74 6f |e PP log| directo|
|000006f0| 72 79 2e 20 5c 5c 0a 09 | 5c 74 74 20 54 41 49 5c |ry. \\..|\tt TAI\|
|00000700| 5f 53 49 47 4e 41 4c 53 | 20 26 20 53 65 74 20 68 |_SIGNALS| & Set h|
|00000710| 61 6e 64 6c 65 72 73 20 | 66 6f 72 20 63 65 72 74 |andlers |for cert|
|00000720| 61 69 6e 20 73 69 67 6e | 61 6c 73 2e 20 5c 5c 0a |ain sign|als. \\.|
|00000730| 09 5c 74 74 20 54 41 49 | 5c 5f 41 4c 4c 20 26 20 |.\tt TAI|\_ALL & |
|00000740| 41 6c 6c 20 6f 66 20 74 | 68 65 20 61 62 6f 76 65 |All of t|he above|
|00000750| 2e 20 5c 5c 0a 5c 68 6c | 69 6e 65 0a 5c 65 6e 64 |. \\.\hl|ine.\end|
|00000760| 7b 74 61 62 75 6c 61 72 | 7d 5c 5d 0a 54 68 65 20 |{tabular|}\].The |
|00000770| 66 6c 61 67 73 20 6d 61 | 79 20 62 65 20 63 6f 6d |flags ma|y be com|
|00000780| 62 69 6e 65 64 20 62 79 | 20 62 69 74 77 69 73 65 |bined by| bitwise|
|00000790| 20 74 68 65 20 62 69 74 | 77 69 73 65 20 6f 72 20 | the bit|wise or |
|000007a0| 6f 70 65 72 61 74 6f 72 | 2e 0a 0a 5c 73 65 63 74 |operator|...\sect|
|000007b0| 69 6f 6e 20 7b 52 75 6e | 74 69 6d 65 20 54 61 69 |ion {Run|time Tai|
|000007c0| 6c 6f 72 69 6e 67 7d 0a | 0a 54 68 65 20 72 75 6e |loring}.|.The run|
|000007d0| 74 69 6d 65 20 74 61 69 | 6c 6f 72 69 6e 67 20 66 |time tai|loring f|
|000007e0| 6f 72 20 50 50 20 69 73 | 20 63 6f 6d 70 6c 65 78 |or PP is| complex|
|000007f0| 2c 20 61 73 20 74 68 65 | 72 65 20 61 72 65 20 6d |, as the|re are m|
|00000800| 61 6e 79 20 70 61 72 61 | 6d 65 74 65 72 73 0a 74 |any para|meters.t|
|00000810| 68 61 74 20 63 61 6e 20 | 61 66 66 65 63 74 20 74 |hat can |affect t|
|00000820| 68 65 20 6f 70 65 72 61 | 74 69 6f 6e 20 6f 66 20 |he opera|tion of |
|00000830| 74 68 65 20 73 79 73 74 | 65 6d 2e 20 54 68 65 20 |the syst|em. The |
|00000840| 6d 61 69 6e 20 74 68 69 | 6e 67 73 20 74 61 69 6c |main thi|ngs tail|
|00000850| 6f 72 65 64 0a 61 72 65 | 20 70 61 74 68 6e 61 6d |ored.are| pathnam|
|00000860| 65 73 20 74 6f 20 6c 6f | 63 61 74 65 20 63 6f 6d |es to lo|cate com|
|00000870| 6d 6f 6e 6c 79 20 75 73 | 65 64 20 70 72 6f 67 72 |monly us|ed progr|
|00000880| 61 6d 73 3b 20 66 69 6c | 65 20 6e 61 6d 65 73 20 |ams; fil|e names |
|00000890| 61 6e 64 0a 64 69 72 65 | 63 74 6f 72 69 65 73 3b |and.dire|ctories;|
|000008a0| 20 6f 72 20 74 68 65 20 | 6d 6f 72 65 20 63 6f 6d | or the |more com|
|000008b0| 70 6c 65 78 20 74 61 69 | 6c 6f 72 69 6e 67 20 74 |plex tai|loring t|
|000008c0| 6f 20 64 65 66 69 6e 65 | 20 73 75 63 68 20 74 68 |o define| such th|
|000008d0| 69 6e 67 73 20 61 73 0a | 63 68 61 6e 6e 65 6c 73 |ings as.|channels|
|000008e0| 20 61 6e 64 20 74 61 62 | 6c 65 73 2e 20 53 65 65 | and tab|les. See|
|000008f0| 20 56 6f 6c 75 6d 65 20 | 31 20 66 6f 72 20 74 68 | Volume |1 for th|
|00000900| 65 20 66 75 6c 6c 20 64 | 65 74 61 69 6c 2e 0a 0a |e full d|etail...|
|00000910| 54 6f 20 61 64 64 20 6e | 65 77 20 69 74 65 6d 73 |To add n|ew items|
|00000920| 20 74 6f 20 62 65 20 74 | 61 69 6c 6f 72 65 64 2c | to be t|ailored,|
|00000930| 20 69 74 20 69 73 20 6e | 65 63 65 73 73 61 72 79 | it is n|ecessary|
|00000940| 20 74 6f 20 61 64 64 20 | 73 6f 6d 65 20 63 6f 64 | to add |some cod|
|00000950| 65 20 74 6f 0a 74 68 65 | 20 70 61 72 73 69 6e 67 |e to.the| parsing|
|00000960| 20 72 6f 75 74 69 6e 65 | 73 2e 20 46 6f 72 20 73 | routine|s. For s|
|00000970| 69 6d 70 6c 65 20 61 64 | 64 69 74 69 6f 6e 73 2c |imple ad|ditions,|
|00000980| 20 69 74 20 69 73 20 6e | 65 63 65 73 73 61 72 79 | it is n|ecessary|
|00000990| 20 6f 6e 6c 79 20 74 6f | 0a 6d 6f 64 69 66 79 20 | only to|.modify |
|000009a0| 74 68 65 20 74 61 62 6c | 65 73 20 61 6e 64 20 74 |the tabl|es and t|
|000009b0| 68 65 20 73 77 69 74 63 | 68 20 73 74 61 74 65 6d |he switc|h statem|
|000009c0| 65 6e 74 20 69 6e 20 74 | 68 65 20 66 69 6c 65 0a |ent in t|he file.|
|000009d0| 5c 66 69 6c 65 7b 70 70 | 2f 4c 69 62 2f 74 61 69 |\file{pp|/Lib/tai|
|000009e0| 2f 74 61 69 5c 5f 73 79 | 73 2e 63 7d 2e 20 4d 6f |/tai\_sy|s.c}. Mo|
|000009f0| 72 65 20 63 6f 6d 70 6c | 65 78 20 74 61 69 6c 6f |re compl|ex tailo|
|00000a00| 72 69 6e 67 20 69 73 20 | 62 65 73 74 20 64 6f 6e |ring is |best don|
|00000a10| 65 20 62 79 0a 63 72 65 | 61 74 69 6e 67 20 61 20 |e by.cre|ating a |
|00000a20| 73 65 70 61 72 61 74 65 | 20 70 72 6f 63 65 64 75 |separate| procedu|
|00000a30| 72 65 2c 20 70 6f 73 73 | 69 62 6c 65 20 69 6e 20 |re, poss|ible in |
|00000a40| 61 20 6e 65 77 20 66 69 | 6c 65 2e 20 53 75 63 68 |a new fi|le. Such|
|00000a50| 20 61 64 64 69 74 69 6f | 6e 61 6c 0a 74 61 69 6c | additio|nal.tail|
|00000a60| 6f 72 69 6e 67 20 73 68 | 6f 75 6c 64 20 6e 6f 74 |oring sh|ould not|
|00000a70| 20 62 65 20 75 6e 64 65 | 72 74 61 6b 65 6e 20 6c | be unde|rtaken l|
|00000a80| 69 67 68 74 6c 79 20 61 | 73 20 69 74 20 77 69 6c |ightly a|s it wil|
|00000a90| 6c 20 6d 61 6b 65 20 74 | 68 65 20 6e 65 77 0a 76 |l make t|he new.v|
|00000aa0| 65 72 73 69 6f 6e 20 6f | 66 20 50 50 20 69 6e 63 |ersion o|f PP inc|
|00000ab0| 6f 6d 70 61 74 61 62 6c | 65 20 77 69 74 68 20 65 |ompatabl|e with e|
|00000ac0| 78 69 73 74 69 6e 67 20 | 61 6e 64 20 6e 65 77 20 |xisting |and new |
|00000ad0| 76 65 72 73 69 6f 6e 73 | 2e 0a 0a 5c 73 65 63 74 |versions|...\sect|
|00000ae0| 69 6f 6e 20 7b 4c 6f 67 | 67 69 6e 67 7d 0a 0a 41 |ion {Log|ging}..A|
|00000af0| 6c 6c 20 6c 6f 67 67 69 | 6e 67 20 77 6f 72 6b 73 |ll loggi|ng works|
|00000b00| 20 74 68 72 6f 75 67 68 | 20 61 20 73 74 61 6e 64 | through| a stand|
|00000b10| 61 72 64 20 70 61 63 6b | 61 67 65 2e 20 54 68 69 |ard pack|age. Thi|
|00000b20| 73 20 70 61 63 6b 61 67 | 65 20 69 6e 63 6c 75 64 |s packag|e includ|
|00000b30| 65 73 0a 66 65 61 74 75 | 72 65 73 20 74 6f 20 6c |es.featu|res to l|
|00000b40| 69 6d 69 74 20 74 68 65 | 20 6c 6f 67 20 66 69 6c |imit the| log fil|
|00000b50| 65 73 20 61 6e 64 20 74 | 6f 20 6e 6f 74 69 66 79 |es and t|o notify|
|00000b60| 20 61 64 6d 69 6e 69 73 | 74 72 61 74 6f 72 73 20 | adminis|trators |
|00000b70| 6f 66 20 65 72 72 6f 72 | 73 2e 0a 54 68 65 20 6c |of error|s..The l|
|00000b80| 6f 67 67 69 6e 67 20 68 | 61 73 20 73 6f 6d 65 20 |ogging h|as some |
|00000b90| 73 74 72 75 63 74 75 72 | 65 20 74 6f 6f 20 69 74 |structur|e too it|
|00000ba0| 20 61 6e 64 20 74 68 65 | 20 66 6f 6c 6c 6f 77 69 | and the| followi|
|00000bb0| 6e 67 20 61 72 65 20 74 | 68 65 0a 67 65 6e 65 72 |ng are t|he.gener|
|00000bc0| 61 6c 20 72 75 6c 65 73 | 20 75 73 65 64 20 77 68 |al rules| used wh|
|00000bd0| 65 6e 20 70 72 6f 67 72 | 61 6d 6d 69 6e 67 20 50 |en progr|amming P|
|00000be0| 50 2e 0a 0a 5c 73 75 62 | 73 65 63 74 69 6f 6e 09 |P...\sub|section.|
|00000bf0| 7b 4c 6f 67 67 69 6e 67 | 20 4c 65 76 65 6c 73 7d |{Logging| Levels}|
|00000c00| 0a 0a 54 68 65 20 6c 6f | 67 67 69 6e 67 20 70 61 |..The lo|gging pa|
|00000c10| 63 6b 61 67 65 20 74 61 | 6b 65 73 20 61 20 62 69 |ckage ta|kes a bi|
|00000c20| 74 20 6d 61 73 6b 20 6f | 66 20 76 61 6c 75 65 73 |t mask o|f values|
|00000c30| 20 74 6f 20 6c 6f 67 2e | 20 54 68 69 73 20 69 73 | to log.| This is|
|00000c40| 0a 63 6f 6d 70 61 72 65 | 64 20 77 69 74 68 20 74 |.compare|d with t|
|00000c50| 68 65 20 63 75 72 72 65 | 6e 74 20 73 65 74 74 69 |he curre|nt setti|
|00000c60| 6e 67 20 6f 66 20 74 68 | 65 20 6c 6f 67 67 69 6e |ng of th|e loggin|
|00000c70| 67 20 6c 65 76 65 6c 20 | 61 6e 64 20 74 68 65 6e |g level |and then|
|00000c80| 0a 63 65 72 74 61 69 6e | 20 76 61 6c 75 65 73 20 |.certain| values |
|00000c90| 61 72 65 20 6c 6f 67 67 | 65 64 2e 20 54 68 65 20 |are logg|ed. The |
|00000ca0| 6c 65 76 65 6c 73 20 61 | 76 61 69 6c 61 62 6c 65 |levels a|vailable|
|00000cb0| 20 61 72 65 20 73 68 6f | 77 6e 20 69 6e 0a 54 61 | are sho|wn in.Ta|
|00000cc0| 62 6c 65 7e 5c 72 65 66 | 7b 74 61 62 3a 6c 6f 67 |ble~\ref|{tab:log|
|00000cd0| 67 69 6e 67 7d 2e 20 54 | 68 65 20 76 61 6c 75 65 |ging}. T|he value|
|00000ce0| 73 20 5c 76 65 72 62 7c | 4c 4c 4f 47 5f 4e 4f 4e |s \verb||LLOG_NON|
|00000cf0| 45 7c 20 61 6e 64 0a 5c | 76 65 72 62 7c 4c 4c 4f |E| and.\|verb|LLO|
|00000d00| 47 5f 41 4c 4c 7c 20 61 | 72 65 20 73 70 65 63 69 |G_ALL| a|re speci|
|00000d10| 61 6c 3a 20 74 68 65 20 | 66 69 72 73 74 20 69 73 |al: the |first is|
|00000d20| 20 6e 6f 20 6c 6f 67 67 | 69 6e 67 20 61 74 20 61 | no logg|ing at a|
|00000d30| 6c 6c 2c 20 74 68 65 0a | 6c 61 74 74 65 72 20 73 |ll, the.|latter s|
|00000d40| 65 74 73 20 61 6c 6c 20 | 62 69 74 73 20 69 6e 20 |ets all |bits in |
|00000d50| 74 68 65 20 62 69 74 6d | 61 73 6b 2e 0a 0a 5c 74 |the bitm|ask...\t|
|00000d60| 61 67 74 61 62 6c 65 7b | 6c 6f 67 7d 7b 4c 6f 67 |agtable{|log}{Log|
|00000d70| 67 69 6e 67 20 4c 65 76 | 65 6c 73 7d 7b 74 61 62 |ging Lev|els}{tab|
|00000d80| 3a 6c 6f 67 67 69 6e 67 | 7d 0a 0a 5c 73 75 62 73 |:logging|}..\subs|
|00000d90| 65 63 74 69 6f 6e 09 7b | 4c 6f 67 67 69 6e 67 20 |ection.{|Logging |
|00000da0| 53 74 72 75 63 74 75 72 | 65 73 7d 0a 0a 54 68 65 |Structur|es}..The|
|00000db0| 72 65 20 61 72 65 20 74 | 68 72 65 65 20 6c 6f 67 |re are t|hree log|
|00000dc0| 20 73 74 72 75 63 74 75 | 72 65 73 20 75 73 65 64 | structu|res used|
|00000dd0| 20 69 6e 20 50 50 2e 20 | 54 68 65 20 73 74 72 75 | in PP. |The stru|
|00000de0| 63 74 75 72 65 73 20 74 | 68 65 6d 73 65 6c 76 65 |ctures t|hemselve|
|00000df0| 73 0a 61 72 65 20 64 65 | 66 69 6e 65 64 20 69 6e |s.are de|fined in|
|00000e00| 20 74 68 65 20 69 6e 63 | 6c 75 64 65 20 66 69 6c | the inc|lude fil|
|00000e10| 65 20 5c 66 69 6c 65 7b | 69 73 6f 64 65 2f 6c 6f |e \file{|isode/lo|
|00000e20| 67 67 65 72 2e 68 7d 2e | 20 20 54 68 65 73 65 0a |gger.h}.| These.|
|00000e30| 73 74 72 75 63 74 75 72 | 65 73 20 61 72 65 20 6f |structur|es are o|
|00000e40| 66 20 74 79 70 65 20 5c | 6d 62 6f 78 7b 5c 76 65 |f type \|mbox{\ve|
|00000e50| 72 62 7c 4c 4c 6f 67 20 | 2a 7c 7d 5c 69 6e 64 65 |rb|LLog |*|}\inde|
|00000e60| 78 7b 4c 4c 6f 67 7d 20 | 61 6e 64 20 61 72 65 20 |x{LLog} |and are |
|00000e70| 74 68 65 0a 66 6f 6c 6c | 6f 77 69 6e 67 3a 0a 0a |the.foll|owing:..|
|00000e80| 5c 69 6e 64 65 78 7b 6c | 6f 67 5c 5f 6e 6f 72 6d |\index{l|og\_norm|
|00000e90| 7d 5c 69 6e 64 65 78 7b | 6c 6f 67 5c 5f 73 74 61 |}\index{|log\_sta|
|00000ea0| 74 7d 5c 69 6e 64 65 78 | 7b 6c 6f 67 5c 5f 6f 70 |t}\index|{log\_op|
|00000eb0| 65 72 7d 25 0a 5c 5b 5c | 62 65 67 69 6e 7b 74 61 |er}%.\[\|begin{ta|
|00000ec0| 62 75 6c 61 72 7d 7b 7c | 6c 7c 6c 7c 7d 0a 5c 68 |bular}{||l|l|}.\h|
|00000ed0| 6c 69 6e 65 0a 09 5c 6d | 75 6c 74 69 63 6f 6c 75 |line..\m|ulticolu|
|00000ee0| 6d 6e 7b 31 7d 7b 7c 63 | 7c 7d 7b 5c 62 66 20 53 |mn{1}{|c||}{\bf S|
|00000ef0| 74 72 75 63 74 75 72 65 | 7d 26 0a 09 09 5c 6d 75 |tructure|}&...\mu|
|00000f00| 6c 74 69 63 6f 6c 75 6d | 6e 7b 31 7d 7b 7c 63 7c |lticolum|n{1}{|c||
|00000f10| 7d 7b 5c 62 66 20 55 73 | 61 67 65 7d 5c 5c 0a 5c |}{\bf Us|age}\\.\|
|00000f20| 68 6c 69 6e 65 0a 09 5c | 74 74 20 6c 6f 67 5c 5f |hline..\|tt log\_|
|00000f30| 6e 6f 72 6d 26 09 4e 6f | 72 6d 61 6c 20 6c 6f 67 |norm&.No|rmal log|
|00000f40| 67 69 6e 67 5c 5c 0a 09 | 5c 74 74 20 6c 6f 67 5c |ging\\..|\tt log\|
|00000f50| 5f 6f 70 65 72 26 09 43 | 72 69 74 69 63 61 6c 20 |_oper&.C|ritical |
|00000f60| 4f 70 65 72 61 74 6f 72 | 20 6d 65 73 73 61 67 65 |Operator| message|
|00000f70| 5c 5c 0a 09 5c 74 74 20 | 6c 6f 67 5c 5f 73 74 61 |\\..\tt |log\_sta|
|00000f80| 74 26 09 53 74 61 74 69 | 73 74 69 63 61 6c 20 61 |t&.Stati|stical a|
|00000f90| 6e 64 20 41 75 74 68 6f | 72 69 73 61 74 69 6f 6e |nd Autho|risation|
|00000fa0| 20 5c 5c 0a 5c 68 6c 69 | 6e 65 0a 5c 65 6e 64 7b | \\.\hli|ne.\end{|
|00000fb0| 74 61 62 75 6c 61 72 7d | 5c 5d 0a 54 68 65 73 65 |tabular}|\].These|
|00000fc0| 20 73 74 72 75 63 74 75 | 72 65 73 20 61 72 65 20 | structu|res are |
|00000fd0| 72 61 72 65 6c 79 20 75 | 73 65 64 20 65 78 70 6c |rarely u|sed expl|
|00000fe0| 69 63 69 74 6c 79 2e 20 | 57 69 74 68 20 66 65 77 |icitly. |With few|
|00000ff0| 20 65 78 63 65 70 74 69 | 6f 6e 73 2c 20 74 68 65 | excepti|ons, the|
|00001000| 0a 6c 6f 67 67 69 6e 67 | 20 6d 61 63 72 6f 73 20 |.logging| macros |
|00001010| 64 65 73 63 72 69 62 65 | 64 20 62 65 6c 6f 77 20 |describe|d below |
|00001020| 75 73 65 20 74 68 65 20 | 5c 76 65 72 62 7c 6c 6f |use the |\verb|lo|
|00001030| 67 5f 6e 6f 72 6d 7c 20 | 73 74 72 75 63 74 75 72 |g_norm| |structur|
|00001040| 65 2e 0a 0a 5c 73 75 62 | 73 65 63 74 69 6f 6e 09 |e...\sub|section.|
|00001050| 7b 4c 6f 67 67 69 6e 67 | 20 4d 61 63 72 6f 73 7d |{Logging| Macros}|
|00001060| 5c 6c 61 62 65 6c 7b 6c | 6f 67 67 69 6e 67 7d 0a |\label{l|ogging}.|
|00001070| 54 68 65 72 65 20 61 72 | 65 20 73 65 76 65 72 61 |There ar|e severa|
|00001080| 6c 20 6d 61 63 72 6f 73 | 20 64 65 66 69 6e 65 64 |l macros| defined|
|00001090| 20 74 6f 20 61 69 64 20 | 69 6e 20 74 68 65 20 75 | to aid |in the u|
|000010a0| 73 65 20 6f 66 20 6c 6f | 67 67 69 6e 67 2e 20 54 |se of lo|gging. T|
|000010b0| 68 65 0a 64 65 66 69 6e | 69 74 69 6f 6e 73 20 6f |he.defin|itions o|
|000010c0| 66 20 74 68 65 73 65 20 | 6d 61 63 72 6f 73 20 63 |f these |macros c|
|000010d0| 61 6e 20 62 65 20 66 6f | 75 6e 64 20 69 6e 20 74 |an be fo|und in t|
|000010e0| 68 65 20 69 6e 63 6c 75 | 64 65 20 66 69 6c 65 0a |he inclu|de file.|
|000010f0| 5c 66 69 6c 65 7b 6c 6c | 5c 5f 6c 6f 67 2e 68 7d |\file{ll|\_log.h}|
|00001100| 2e 20 54 68 65 73 65 20 | 6d 61 63 72 6f 73 20 6d |. These |macros m|
|00001110| 61 79 20 62 65 20 75 73 | 65 64 20 69 6e 20 74 68 |ay be us|ed in th|
|00001120| 65 20 66 6f 6c 6c 6f 77 | 69 6e 67 20 77 61 79 3a |e follow|ing way:|
|00001130| 0a 5c 62 65 67 69 6e 7b | 71 75 6f 74 65 7d 5c 69 |.\begin{|quote}\i|
|00001140| 6e 64 65 78 7b 50 50 5c | 5f 4c 4f 47 7d 5c 62 65 |ndex{PP\|_LOG}\be|
|00001150| 67 69 6e 7b 76 65 72 62 | 61 74 69 6d 7d 0a 50 50 |gin{verb|atim}.PP|
|00001160| 5f 4c 4f 47 20 28 6c 65 | 76 65 6c 2c 20 28 66 6f |_LOG (le|vel, (fo|
|00001170| 72 6d 61 74 2c 20 61 72 | 67 31 2c 20 61 72 67 32 |rmat, ar|g1, arg2|
|00001180| 20 2e 2e 2e 29 29 0a 69 | 6e 74 20 20 20 20 6c 65 | ...)).i|nt le|
|00001190| 76 65 6c 3b 0a 63 68 61 | 72 20 20 20 2a 73 74 72 |vel;.cha|r *str|
|000011a0| 3b 0a 5c 65 6e 64 7b 76 | 65 72 62 61 74 69 6d 7d |;.\end{v|erbatim}|
|000011b0| 5c 65 6e 64 7b 71 75 6f | 74 65 7d 0a 54 68 69 73 |\end{quo|te}.This|
|000011c0| 20 6d 61 63 72 6f 20 69 | 73 20 75 73 65 64 20 66 | macro i|s used f|
|000011d0| 6f 72 20 6d 6f 73 74 20 | 6f 66 20 74 68 65 20 6e |or most |of the n|
|000011e0| 6f 6e 2d 64 65 62 75 67 | 67 69 6e 67 20 6c 6f 67 |on-debug|ging log|
|000011f0| 67 69 6e 67 2e 20 54 68 | 65 0a 61 72 67 75 6d 65 |ging. Th|e.argume|
|00001200| 6e 74 73 20 74 6f 20 74 | 68 69 73 20 63 61 6c 6c |nts to t|his call|
|00001210| 20 61 72 65 20 61 73 20 | 66 6f 6c 6c 6f 77 73 3a | are as |follows:|
|00001220| 0a 5c 62 65 67 69 6e 7b | 64 65 73 63 72 69 62 65 |.\begin{|describe|
|00001230| 7d 0a 5c 69 74 65 6d 5b | 5c 76 65 72 62 7c 6c 65 |}.\item[|\verb|le|
|00001240| 76 65 6c 7c 3a 5d 09 4f | 6e 65 20 6f 66 20 74 68 |vel|:].O|ne of th|
|00001250| 65 20 6c 6f 67 67 69 6e | 67 20 6c 65 76 65 6c 73 |e loggin|g levels|
|00001260| 20 73 70 65 63 69 66 69 | 65 64 20 61 62 6f 76 65 | specifi|ed above|
|00001270| 2e 0a 48 6f 77 65 76 65 | 72 2c 20 61 73 20 74 68 |..Howeve|r, as th|
|00001280| 65 72 65 20 61 72 65 20 | 6d 61 63 72 6f 73 20 70 |ere are |macros p|
|00001290| 72 6f 76 69 64 65 64 20 | 66 6f 72 20 66 61 74 61 |rovided |for fata|
|000012a0| 6c 20 65 72 72 6f 72 73 | 20 61 6e 64 20 64 65 62 |l errors| and deb|
|000012b0| 75 67 67 69 6e 67 2c 0a | 69 74 20 69 73 20 75 73 |ugging,.|it is us|
|000012c0| 75 61 6c 6c 79 20 6f 6e | 6c 79 20 74 68 65 20 76 |ually on|ly the v|
|000012d0| 61 6c 75 65 73 20 6f 66 | 20 0a 5c 6c 69 6e 65 62 |alues of| .\lineb|
|000012e0| 72 65 61 6b 0a 5c 76 65 | 72 62 7c 4c 4c 4f 47 5f |reak.\ve|rb|LLOG_|
|000012f0| 45 58 43 45 50 54 49 4f | 4e 53 7c 20 61 6e 64 0a |EXCEPTIO|NS| and.|
|00001300| 5c 76 65 72 62 7c 4c 4c | 4f 47 5f 50 44 55 53 7c |\verb|LL|OG_PDUS||
|00001310| 20 77 68 69 63 68 20 61 | 72 65 20 75 73 65 64 20 | which a|re used |
|00001320| 61 73 20 74 68 65 20 61 | 72 67 75 6d 65 6e 74 20 |as the a|rgument |
|00001330| 68 65 72 65 2e 20 54 68 | 65 0a 5c 76 65 72 62 7c |here. Th|e.\verb||
|00001340| 4c 4c 4f 47 5f 45 58 43 | 45 50 54 49 4f 4e 53 7c |LLOG_EXC|EPTIONS||
|00001350| 20 69 73 20 75 73 65 64 | 20 74 6f 20 6c 6f 67 20 | is used| to log |
|00001360| 66 61 69 6c 75 72 65 73 | 20 74 68 61 74 20 61 72 |failures| that ar|
|00001370| 65 20 6e 6f 74 20 63 72 | 69 74 69 63 61 6c 2e 0a |e not cr|itical..|
|00001380| 54 68 65 20 5c 76 65 72 | 62 7c 4c 4c 4f 47 5f 50 |The \ver|b|LLOG_P|
|00001390| 44 55 53 7c 20 6c 65 76 | 65 6c 20 69 73 20 75 73 |DUS| lev|el is us|
|000013a0| 65 64 20 74 6f 20 74 72 | 61 63 65 20 61 6e 79 20 |ed to tr|ace any |
|000013b0| 70 72 6f 74 6f 63 6f 6c | 20 65 78 63 68 61 6e 67 |protocol| exchang|
|000013c0| 65 73 20 2d 2d 0a 75 73 | 69 6e 67 20 74 68 65 0a |es --.us|ing the.|
|000013d0| 5c 76 65 72 62 7c 50 50 | 5f 50 44 55 53 7c 20 6d |\verb|PP|_PDUS| m|
|000013e0| 61 63 72 6f 20 69 66 20 | 73 75 69 74 61 62 6c 65 |acro if |suitable|
|000013f0| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 76 65 72 62 7c 66 |...\item|[\verb|f|
|00001400| 6f 72 6d 61 74 7c 3a 5d | 09 54 68 69 73 20 69 73 |ormat|:]|.This is|
|00001410| 20 61 20 70 72 69 6e 74 | 66 2d 6c 69 6b 65 20 66 | a print|f-like f|
|00001420| 6f 72 6d 61 74 20 73 74 | 72 69 6e 67 20 77 68 69 |ormat st|ring whi|
|00001430| 63 68 0a 74 6f 67 65 74 | 68 65 72 20 77 69 74 68 |ch.toget|her with|
|00001440| 20 61 6e 79 20 61 72 67 | 75 6d 65 6e 74 73 20 7b | any arg|uments {|
|00001450| 5c 65 6d 20 6d 75 73 74 | 7d 20 62 65 20 65 6e 63 |\em must|} be enc|
|00001460| 6c 6f 73 65 64 20 69 6e | 20 62 72 61 63 6b 65 74 |losed in| bracket|
|00001470| 73 20 61 73 0a 73 68 6f | 77 6e 2e 20 54 68 65 0a |s as.sho|wn. The.|
|00001480| 5c 76 65 72 62 7c 66 6f | 72 6d 61 74 7c 20 61 6e |\verb|fo|rmat| an|
|00001490| 64 20 61 6e 79 20 6e 75 | 6d 62 65 72 20 6f 66 20 |d any nu|mber of |
|000014a0| 6f 70 74 69 6f 6e 61 6c | 20 5c 76 65 72 62 7c 61 |optional| \verb|a|
|000014b0| 72 67 7c 73 20 70 72 6f | 64 75 63 65 20 74 68 65 |rg|s pro|duce the|
|000014c0| 0a 6c 6f 67 67 69 6e 67 | 20 6d 65 73 73 61 67 65 |.logging| message|
|000014d0| 2e 0a 5c 65 6e 64 7b 64 | 65 73 63 72 69 62 65 7d |..\end{d|escribe}|
|000014e0| 0a 0a 54 68 65 20 6e 65 | 78 74 20 6d 61 63 72 6f |..The ne|xt macro|
|000014f0| 20 69 73 20 61 20 6d 6f | 72 65 20 67 65 6e 65 72 | is a mo|re gener|
|00001500| 61 6c 20 6d 61 63 72 6f | 20 77 68 69 63 68 20 61 |al macro| which a|
|00001510| 6c 6c 6f 77 73 20 6c 6f | 67 67 69 6e 67 20 6f 66 |llows lo|gging of|
|00001520| 20 73 79 73 74 65 6d 0a | 65 72 72 6f 72 20 6d 65 | system.|error me|
|00001530| 73 73 61 67 65 73 20 74 | 6f 20 62 65 20 61 74 74 |ssages t|o be att|
|00001540| 61 63 68 65 64 20 74 6f | 20 74 68 65 20 62 61 73 |ached to| the bas|
|00001550| 69 63 20 6c 6f 67 20 6d | 65 73 73 61 67 65 2e 0a |ic log m|essage..|
|00001560| 0a 5c 62 65 67 69 6e 7b | 71 75 6f 74 65 7d 5c 69 |.\begin{|quote}\i|
|00001570| 6e 64 65 78 7b 50 50 5c | 5f 53 4c 4f 47 7d 5c 62 |ndex{PP\|_SLOG}\b|
|00001580| 65 67 69 6e 7b 76 65 72 | 62 61 74 69 6d 7d 0a 50 |egin{ver|batim}.P|
|00001590| 50 5f 53 4c 4f 47 20 28 | 6c 65 76 65 6c 2c 20 77 |P_SLOG (|level, w|
|000015a0| 68 61 74 2c 20 28 66 6f | 72 6d 61 74 2c 20 61 72 |hat, (fo|rmat, ar|
|000015b0| 67 31 2c 20 61 72 67 32 | 20 2e 2e 2e 29 29 0a 69 |g1, arg2| ...)).i|
|000015c0| 6e 74 20 20 6c 65 76 65 | 6c 3b 0a 63 68 61 72 20 |nt leve|l;.char |
|000015d0| 2a 77 68 61 74 3b 0a 63 | 68 61 72 20 2a 66 6f 72 |*what;.c|har *for|
|000015e0| 6d 61 74 3b 0a 5c 65 6e | 64 7b 76 65 72 62 61 74 |mat;.\en|d{verbat|
|000015f0| 69 6d 7d 5c 65 6e 64 7b | 71 75 6f 74 65 7d 0a 54 |im}\end{|quote}.T|
|00001600| 68 69 73 20 69 73 20 73 | 69 6d 69 6c 61 72 20 74 |his is s|imilar t|
|00001610| 6f 20 74 68 65 20 5c 76 | 65 72 62 7c 50 50 5f 4c |o the \v|erb|PP_L|
|00001620| 4f 47 7c 20 6d 61 63 72 | 6f 2c 20 62 75 74 20 74 |OG| macr|o, but t|
|00001630| 68 65 20 65 78 74 72 61 | 20 61 72 67 75 6d 65 6e |he extra| argumen|
|00001640| 74 20 69 66 0a 6e 6f 74 | 20 6e 75 6c 6c 20 65 6e |t if.not| null en|
|00001650| 73 75 72 65 73 20 74 68 | 61 74 20 6f 70 65 72 61 |sures th|at opera|
|00001660| 74 69 6e 67 20 73 79 73 | 74 65 6d 20 63 61 6c 6c |ting sys|tem call|
|00001670| 20 66 61 69 6c 75 72 65 | 73 20 61 72 65 20 6c 6f | failure|s are lo|
|00001680| 67 67 65 64 20 61 73 0a | 77 65 6c 6c 2e 20 54 68 |gged as.|well. Th|
|00001690| 69 73 20 6d 61 63 72 6f | 20 73 68 6f 75 6c 64 20 |is macro| should |
|000016a0| 62 65 20 75 73 65 64 20 | 77 68 65 72 65 20 69 74 |be used |where it|
|000016b0| 20 69 73 20 73 75 73 70 | 65 63 74 65 64 20 74 68 | is susp|ected th|
|000016c0| 61 74 20 61 20 73 79 73 | 74 65 6d 0a 63 61 6c 6c |at a sys|tem.call|
|000016d0| 20 68 61 73 20 66 61 69 | 6c 65 64 2e 0a 5c 62 65 | has fai|led..\be|
|000016e0| 67 69 6e 7b 64 65 73 63 | 72 69 62 65 7d 0a 5c 69 |gin{desc|ribe}.\i|
|000016f0| 74 65 6d 5b 5c 76 65 72 | 62 7c 6c 65 76 65 6c 7c |tem[\ver|b|level||
|00001700| 3a 5d 09 54 68 65 20 6c | 6f 67 67 69 6e 67 20 6c |:].The l|ogging l|
|00001710| 65 76 65 6c 2e 0a 5c 69 | 74 65 6d 5b 5c 76 65 72 |evel..\i|tem[\ver|
|00001720| 62 7c 77 68 61 74 7c 3a | 5d 09 41 20 73 74 72 69 |b|what|:|].A stri|
|00001730| 6e 67 20 77 68 69 63 68 | 20 69 66 20 6e 6f 74 20 |ng which| if not |
|00001740| 74 68 65 20 6e 75 6c 6c | 20 70 6f 69 6e 74 65 72 |the null| pointer|
|00001750| 20 6c 6f 67 73 0a 74 68 | 65 20 73 79 73 74 65 6d | logs.th|e system|
|00001760| 20 65 72 72 6f 72 2e 0a | 5c 69 74 65 6d 5b 5c 76 | error..|\item[\v|
|00001770| 65 72 62 7c 66 6f 72 6d | 61 74 7c 3a 5d 09 41 20 |erb|form|at|:].A |
|00001780| 70 72 69 6e 74 66 2d 6c | 69 6b 65 20 66 6f 72 6d |printf-l|ike form|
|00001790| 61 74 20 73 74 72 69 6e | 67 2e 0a 5c 65 6e 64 7b |at strin|g..\end{|
|000017a0| 64 65 73 63 72 69 62 65 | 7d 0a 0a 46 6f 72 20 6d |describe|}..For m|
|000017b0| 6f 72 65 20 75 72 67 65 | 6e 74 20 63 61 73 65 73 |ore urge|nt cases|
|000017c0| 20 6f 66 20 6c 6f 67 67 | 69 6e 67 2c 20 74 68 65 | of logg|ing, the|
|000017d0| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 6d 61 63 72 6f | followi|ng macro|
|000017e0| 20 69 73 20 70 72 6f 76 | 69 64 65 64 3a 0a 0a 5c | is prov|ided:..\|
|000017f0| 62 65 67 69 6e 7b 71 75 | 6f 74 65 7d 5c 69 6e 64 |begin{qu|ote}\ind|
|00001800| 65 78 7b 50 50 5c 5f 4f | 50 45 52 7d 5c 62 65 67 |ex{PP\_O|PER}\beg|
|00001810| 69 6e 7b 76 65 72 62 61 | 74 69 6d 7d 0a 50 50 5f |in{verba|tim}.PP_|
|00001820| 4f 50 45 52 20 28 77 68 | 61 74 2c 20 28 66 6f 72 |OPER (wh|at, (for|
|00001830| 6d 61 74 2c 20 61 72 67 | 31 2c 20 61 72 67 32 20 |mat, arg|1, arg2 |
|00001840| 2e 2e 2e 29 29 0a 63 68 | 61 72 20 20 20 2a 77 68 |...)).ch|ar *wh|
|00001850| 61 74 2c 20 2a 66 6f 72 | 6d 61 74 3b 0a 5c 65 6e |at, *for|mat;.\en|
|00001860| 64 7b 76 65 72 62 61 74 | 69 6d 7d 5c 65 6e 64 7b |d{verbat|im}\end{|
|00001870| 71 75 6f 74 65 7d 0a 0a | 54 68 69 73 20 6d 61 63 |quote}..|This mac|
|00001880| 72 6f 20 69 73 20 75 73 | 65 64 20 66 6f 72 20 6c |ro is us|ed for l|
|00001890| 6f 67 67 69 6e 67 20 6f | 66 20 65 78 74 72 65 6d |ogging o|f extrem|
|000018a0| 65 20 70 72 6f 62 6c 65 | 6d 73 2e 20 49 74 20 73 |e proble|ms. It s|
|000018b0| 68 6f 75 6c 64 20 6f 6e | 6c 79 20 62 65 0a 75 73 |hould on|ly be.us|
|000018c0| 65 64 20 66 6f 72 20 65 | 72 72 6f 72 73 20 74 68 |ed for e|rrors th|
|000018d0| 61 74 20 72 65 71 75 69 | 72 65 20 6f 70 65 72 61 |at requi|re opera|
|000018e0| 74 6f 72 20 69 6e 74 65 | 72 76 65 6e 74 69 6f 6e |tor inte|rvention|
|000018f0| 2e 20 54 68 65 73 65 20 | 65 72 72 6f 72 73 0a 74 |. These |errors.t|
|00001900| 79 70 69 63 61 6c 6c 79 | 20 65 6e 64 20 75 70 20 |ypically| end up |
|00001910| 69 6e 20 61 20 73 65 70 | 61 72 61 74 65 20 6c 6f |in a sep|arate lo|
|00001920| 67 20 61 73 20 77 65 6c | 6c 20 61 73 20 74 68 65 |g as wel|l as the|
|00001930| 20 6e 6f 72 6d 61 6c 20 | 6c 6f 67 20 61 6e 64 20 | normal |log and |
|00001940| 61 72 65 0a 61 6c 77 61 | 79 73 20 6c 6f 67 67 65 |are.alwa|ys logge|
|00001950| 64 20 61 74 20 74 68 65 | 20 5c 76 65 72 62 7c 4c |d at the| \verb|L|
|00001960| 4c 4f 47 5f 46 41 54 41 | 4c 7c 20 6c 65 76 65 6c |LOG_FATA|L| level|
|00001970| 2e 20 49 74 20 69 73 20 | 61 73 73 75 6d 65 64 20 |. It is |assumed |
|00001980| 74 68 61 74 20 74 68 65 | 0a 73 79 73 74 65 6d 20 |that the|.system |
|00001990| 61 64 6d 69 6e 69 73 74 | 72 61 74 6f 72 20 77 69 |administ|rator wi|
|000019a0| 6c 6c 20 6c 6f 6f 6b 20 | 74 68 72 6f 75 67 68 20 |ll look |through |
|000019b0| 74 68 69 73 20 6c 6f 67 | 20 66 72 65 71 75 65 6e |this log| frequen|
|000019c0| 74 6c 79 20 61 6e 64 20 | 77 69 6c 6c 0a 69 6d 6d |tly and |will.imm|
|000019d0| 65 64 69 61 74 65 6c 79 | 20 74 61 6b 65 20 61 63 |ediately| take ac|
|000019e0| 74 69 6f 6e 20 6f 6e 20 | 61 6e 79 74 68 69 6e 67 |tion on |anything|
|000019f0| 20 66 6f 75 6e 64 20 74 | 68 65 72 65 2e 20 54 68 | found t|here. Th|
|00001a00| 65 20 61 72 67 75 6d 65 | 6e 74 73 20 61 72 65 3a |e argume|nts are:|
|00001a10| 0a 5c 62 65 67 69 6e 7b | 64 65 73 63 72 69 62 65 |.\begin{|describe|
|00001a20| 7d 0a 5c 69 74 65 6d 5b | 5c 76 65 72 62 7c 77 68 |}.\item[|\verb|wh|
|00001a30| 61 74 7c 3a 5d 09 54 68 | 69 73 20 69 73 20 61 20 |at|:].Th|is is a |
|00001a40| 73 74 72 69 6e 67 20 77 | 68 69 63 68 20 69 73 20 |string w|hich is |
|00001a50| 75 73 65 64 20 74 6f 20 | 63 6f 6e 73 74 72 75 63 |used to |construc|
|00001a60| 74 20 61 0a 73 79 73 74 | 65 6d 20 65 72 72 6f 72 |t a.syst|em error|
|00001a70| 20 6d 65 73 73 61 67 65 | 2e 20 54 68 69 73 20 73 | message|. This s|
|00001a80| 68 6f 75 6c 64 20 6f 6e | 6c 79 20 62 65 20 70 72 |hould on|ly be pr|
|00001a90| 65 73 65 6e 74 20 69 66 | 20 61 20 73 79 73 74 65 |esent if| a syste|
|00001aa0| 6d 20 63 61 6c 6c 20 69 | 73 0a 73 75 73 70 65 63 |m call i|s.suspec|
|00001ab0| 74 65 64 20 6f 66 20 66 | 61 69 6c 69 6e 67 2e 20 |ted of f|ailing. |
|00001ac0| 4f 74 68 65 72 77 69 73 | 65 20 74 68 65 20 63 6f |Otherwis|e the co|
|00001ad0| 6e 73 74 61 6e 74 20 5c | 76 65 72 62 7c 4e 55 4c |nstant \|verb|NUL|
|00001ae0| 4c 43 50 7c 20 73 68 6f | 75 6c 64 20 62 65 20 75 |LCP| sho|uld be u|
|00001af0| 73 65 64 2e 0a 0a 5c 69 | 74 65 6d 5b 5c 76 65 72 |sed...\i|tem[\ver|
|00001b00| 62 7c 66 6f 72 6d 61 74 | 7c 3a 5d 09 54 68 69 73 |b|format||:].This|
|00001b10| 20 73 74 72 69 6e 67 20 | 69 73 20 75 73 65 64 20 | string |is used |
|00001b20| 61 73 20 61 20 70 72 69 | 6e 74 66 20 6c 69 6b 65 |as a pri|ntf like|
|00001b30| 20 73 79 6e 74 61 78 0a | 74 6f 20 70 72 6f 64 75 | syntax.|to produ|
|00001b40| 63 65 20 74 68 65 20 6d | 65 73 73 61 67 65 20 74 |ce the m|essage t|
|00001b50| 6f 67 65 74 68 65 72 20 | 77 69 74 68 20 6f 70 74 |ogether |with opt|
|00001b60| 69 6f 6e 61 6c 20 61 72 | 67 75 6d 65 6e 74 73 20 |ional ar|guments |
|00001b70| 61 73 20 69 6e 20 74 68 | 65 20 63 61 73 65 0a 6f |as in th|e case.o|
|00001b80| 66 20 5c 76 65 72 62 7c | 50 50 5f 4c 4f 47 7c 2e |f \verb||PP_LOG|.|
|00001b90| 20 41 67 61 69 6e 2c 20 | 74 68 69 73 20 70 61 72 | Again, |this par|
|00001ba0| 61 6d 65 74 65 72 20 61 | 6e 64 20 61 6e 79 20 61 |ameter a|nd any a|
|00001bb0| 72 67 75 6d 65 6e 74 73 | 20 7b 5c 65 6d 20 6d 75 |rguments| {\em mu|
|00001bc0| 73 74 7d 0a 62 65 20 65 | 6e 63 6c 6f 73 65 64 20 |st}.be e|nclosed |
|00001bd0| 69 6e 20 62 72 61 63 6b | 65 74 73 20 61 73 20 73 |in brack|ets as s|
|00001be0| 68 6f 77 6e 2e 0a 5c 65 | 6e 64 7b 64 65 73 63 72 |hown..\e|nd{descr|
|00001bf0| 69 62 65 7d 0a 0a 41 6e | 6f 74 68 65 72 20 6c 6f |ibe}..An|other lo|
|00001c00| 67 67 69 6e 67 20 63 61 | 6c 6c 20 69 73 20 70 72 |gging ca|ll is pr|
|00001c10| 6f 76 69 64 65 64 20 66 | 6f 72 20 73 74 61 74 69 |ovided f|or stati|
|00001c20| 73 74 69 63 61 6c 20 61 | 6e 64 20 61 75 74 68 6f |stical a|nd autho|
|00001c30| 72 69 73 61 74 69 6f 6e | 61 6c 0a 64 61 74 61 3a |risation|al.data:|
|00001c40| 0a 0a 5c 62 65 67 69 6e | 7b 71 75 6f 74 65 7d 5c |..\begin|{quote}\|
|00001c50| 69 6e 64 65 78 7b 50 50 | 5c 5f 53 54 41 54 7d 5c |index{PP|\_STAT}\|
|00001c60| 62 65 67 69 6e 7b 76 65 | 72 62 61 74 69 6d 7d 0a |begin{ve|rbatim}.|
|00001c70| 50 50 5f 53 54 41 54 20 | 28 28 66 6f 72 6d 61 74 |PP_STAT |((format|
|00001c80| 2c 20 61 72 67 31 2c 20 | 61 72 67 32 20 2e 2e 2e |, arg1, |arg2 ...|
|00001c90| 29 29 0a 63 68 61 72 20 | 20 20 2a 66 6f 72 6d 61 |)).char | *forma|
|00001ca0| 74 3b 0a 5c 65 6e 64 7b | 76 65 72 62 61 74 69 6d |t;.\end{|verbatim|
|00001cb0| 7d 5c 65 6e 64 7b 71 75 | 6f 74 65 7d 0a 54 68 69 |}\end{qu|ote}.Thi|
|00001cc0| 73 20 6d 61 63 72 6f 20 | 69 73 20 75 73 65 64 20 |s macro |is used |
|00001cd0| 66 6f 72 20 6c 6f 67 67 | 69 6e 67 20 73 74 61 74 |for logg|ing stat|
|00001ce0| 69 73 74 69 63 61 6c 20 | 69 6e 66 6f 72 6d 61 74 |istical |informat|
|00001cf0| 69 6f 6e 2e 20 49 74 20 | 73 68 6f 75 6c 64 20 62 |ion. It |should b|
|00001d00| 65 0a 75 73 65 64 20 77 | 68 65 72 65 20 75 73 65 |e.used w|here use|
|00001d10| 66 75 6c 20 74 6f 20 72 | 65 63 6f 72 64 20 73 74 |ful to r|ecord st|
|00001d20| 61 74 69 73 74 69 63 73 | 20 6c 69 6b 65 20 6e 75 |atistics| like nu|
|00001d30| 6d 62 65 72 20 6f 66 20 | 6d 65 73 73 61 67 65 73 |mber of |messages|
|00001d40| 20 61 6e 64 0a 74 69 6d | 65 73 2c 20 65 74 63 2e | and.tim|es, etc.|
|00001d50| 20 49 74 73 20 61 72 67 | 75 6d 65 6e 74 73 20 61 | Its arg|uments a|
|00001d60| 72 65 20 70 72 69 6e 74 | 66 20 6c 69 6b 65 2c 20 |re print|f like, |
|00001d70| 61 6e 64 20 7b 5c 65 6d | 20 6d 75 73 74 7d 20 62 |and {\em| must} b|
|00001d80| 65 20 65 6e 63 6c 6f 73 | 65 64 0a 69 6e 20 74 68 |e enclos|ed.in th|
|00001d90| 65 20 64 6f 75 62 6c 65 | 20 62 72 61 63 6b 65 74 |e double| bracket|
|00001da0| 73 20 61 73 20 73 68 6f | 77 6e 2e 0a 0a 5c 62 65 |s as sho|wn...\be|
|00001db0| 67 69 6e 7b 71 75 6f 74 | 65 7d 5c 69 6e 64 65 78 |gin{quot|e}\index|
|00001dc0| 7b 50 50 5c 5f 4e 4f 54 | 49 43 45 7d 5c 62 65 67 |{PP\_NOT|ICE}\beg|
|00001dd0| 69 6e 7b 76 65 72 62 61 | 74 69 6d 7d 0a 50 50 5f |in{verba|tim}.PP_|
|00001de0| 4e 4f 54 49 43 45 20 28 | 28 66 6f 72 6d 61 74 2c |NOTICE (|(format,|
|00001df0| 20 61 72 67 31 2c 20 61 | 72 67 32 20 2e 2e 2e 29 | arg1, a|rg2 ...)|
|00001e00| 29 0a 63 68 61 72 20 20 | 20 2a 66 6f 72 6d 61 74 |).char | *format|
|00001e10| 0a 5c 65 6e 64 7b 76 65 | 72 62 61 74 69 6d 7d 5c |.\end{ve|rbatim}\|
|00001e20| 65 6e 64 7b 71 75 6f 74 | 65 7d 0a 54 68 69 73 20 |end{quot|e}.This |
|00001e30| 6d 61 63 72 6f 20 69 73 | 20 75 73 65 64 20 74 6f |macro is| used to|
|00001e40| 20 72 65 63 6f 72 64 20 | 69 6e 74 65 72 65 73 74 | record |interest|
|00001e50| 69 6e 67 20 65 76 65 6e | 74 73 20 69 6e 20 70 72 |ing even|ts in pr|
|00001e60| 6f 74 6f 63 6f 6c 20 65 | 78 63 68 61 6e 67 65 73 |otocol e|xchanges|
|00001e70| 2e 0a 49 74 20 73 68 6f | 75 6c 64 20 62 65 20 75 |..It sho|uld be u|
|00001e80| 73 65 64 20 73 6f 20 74 | 68 61 74 20 74 68 65 20 |sed so t|hat the |
|00001e90| 62 61 73 69 63 20 66 6c | 6f 77 20 6f 66 20 61 20 |basic fl|ow of a |
|00001ea0| 70 72 6f 67 72 61 6d 20 | 6d 61 79 20 62 65 20 6f |program |may be o|
|00001eb0| 62 73 65 72 76 65 64 2c | 0a 77 69 74 68 6f 75 74 |bserved,|.without|
|00001ec0| 20 75 6e 64 75 65 20 61 | 6d 6f 75 6e 74 73 20 6f | undue a|mounts o|
|00001ed0| 66 20 6c 6f 67 20 66 69 | 6c 65 20 73 70 61 63 65 |f log fi|le space|
|00001ee0| 20 6f 72 20 65 78 74 72 | 61 20 6d 61 63 68 69 6e | or extr|a machin|
|00001ef0| 65 20 6c 6f 61 64 2e 20 | 43 6f 6d 6d 6f 6e 0a 6c |e load. |Common.l|
|00001f00| 6f 67 67 69 6e 67 20 65 | 76 65 6e 74 73 20 73 68 |ogging e|vents sh|
|00001f10| 6f 75 6c 64 20 62 65 3a | 20 63 6f 6e 6e 65 63 74 |ould be:| connect|
|00001f20| 69 6e 67 20 74 6f 20 61 | 20 68 6f 73 74 2c 20 74 |ing to a| host, t|
|00001f30| 65 72 6d 69 6e 61 74 69 | 6e 67 20 61 0a 63 6f 6e |erminati|ng a.con|
|00001f40| 6e 65 63 74 69 6f 6e 2c | 20 61 6e 64 20 74 68 65 |nection,| and the|
|00001f50| 20 74 72 61 6e 73 66 65 | 72 20 6f 66 20 61 20 6d | transfe|r of a m|
|00001f60| 65 73 73 61 67 65 2e 0a | 0a 5c 62 65 67 69 6e 7b |essage..|.\begin{|
|00001f70| 71 75 6f 74 65 7d 5c 69 | 6e 64 65 78 7b 50 50 5c |quote}\i|ndex{PP\|
|00001f80| 5f 54 52 41 43 45 7d 5c | 62 65 67 69 6e 7b 76 65 |_TRACE}\|begin{ve|
|00001f90| 72 62 61 74 69 6d 7d 0a | 50 50 5f 54 52 41 43 45 |rbatim}.|PP_TRACE|
|00001fa0| 20 28 28 66 6f 72 6d 61 | 74 2c 20 61 72 67 31 2c | ((forma|t, arg1,|
|00001fb0| 20 61 72 67 32 20 2e 2e | 2e 29 29 0a 63 68 61 72 | arg2 ..|.)).char|
|00001fc0| 20 20 20 2a 66 6f 72 6d | 61 74 3b 0a 5c 65 6e 64 | *form|at;.\end|
|00001fd0| 7b 76 65 72 62 61 74 69 | 6d 7d 5c 65 6e 64 7b 71 |{verbati|m}\end{q|
|00001fe0| 75 6f 74 65 7d 0a 54 68 | 69 73 20 6d 61 63 72 6f |uote}.Th|is macro|
|00001ff0| 20 69 73 20 75 73 65 64 | 20 74 68 72 6f 75 67 68 | is used| through|
|00002000| 6f 75 74 20 74 68 65 20 | 73 6f 75 72 63 65 20 63 |out the |source c|
|00002010| 6f 64 65 20 74 6f 20 74 | 72 61 63 65 20 74 68 65 |ode to t|race the|
|00002020| 20 63 61 6c 6c 69 6e 67 | 20 6f 66 0a 66 75 6e 63 | calling| of.func|
|00002030| 74 69 6f 6e 73 20 61 6e | 64 20 74 68 65 20 67 65 |tions an|d the ge|
|00002040| 6e 65 72 61 6c 20 66 6c | 6f 77 20 6f 66 20 74 68 |neral fl|ow of th|
|00002050| 65 20 70 72 6f 67 72 61 | 6d 73 20 61 6e 64 20 6c |e progra|ms and l|
|00002060| 69 62 72 61 72 69 65 73 | 2e 20 49 74 20 6c 6f 67 |ibraries|. It log|
|00002070| 73 0a 74 68 65 20 69 6e | 66 6f 72 6d 61 74 69 6f |s.the in|formatio|
|00002080| 6e 20 61 74 20 74 68 65 | 20 5c 76 65 72 62 7c 4c |n at the| \verb|L|
|00002090| 4c 4f 47 5f 54 52 41 43 | 45 7c 20 6c 65 76 65 6c |LOG_TRAC|E| level|
|000020a0| 2c 20 61 6e 64 20 74 68 | 69 73 20 6d 61 63 72 6f |, and th|is macro|
|000020b0| 20 69 73 0a 64 65 70 65 | 6e 64 65 6e 74 20 6f 6e | is.depe|ndent on|
|000020c0| 20 74 68 65 20 76 61 6c | 75 65 20 6f 66 20 74 68 | the val|ue of th|
|000020d0| 65 20 5c 76 65 72 62 7c | 50 50 5f 44 45 42 55 47 |e \verb||PP_DEBUG|
|000020e0| 7c 20 64 65 66 69 6e 65 | 2e 20 49 66 20 74 68 69 || define|. If thi|
|000020f0| 73 20 69 73 20 6e 6f 74 | 0a 64 65 66 69 6e 65 64 |s is not|.defined|
|00002100| 20 74 68 65 6e 20 74 68 | 65 20 5c 76 65 72 62 7c | then th|e \verb||
|00002110| 50 50 5f 54 52 41 43 45 | 7c 20 6d 61 63 72 6f 73 |PP_TRACE|| macros|
|00002120| 20 61 72 65 20 6e 6f 74 | 20 63 6f 6d 70 69 6c 65 | are not| compile|
|00002130| 64 20 69 6e 2e 0a 54 68 | 65 20 61 72 67 75 6d 65 |d in..Th|e argume|
|00002140| 6e 74 73 20 61 72 65 20 | 69 64 65 6e 74 69 63 61 |nts are |identica|
|00002150| 6c 20 74 6f 20 74 68 65 | 20 5c 76 65 72 62 7c 50 |l to the| \verb|P|
|00002160| 50 5f 53 54 41 54 7c 20 | 6d 61 63 72 6f 2e 0a 0a |P_STAT| |macro...|
|00002170| 5c 62 65 67 69 6e 7b 71 | 75 6f 74 65 7d 5c 69 6e |\begin{q|uote}\in|
|00002180| 64 65 78 7b 50 50 5c 5f | 44 42 47 7d 5c 62 65 67 |dex{PP\_|DBG}\beg|
|00002190| 69 6e 7b 76 65 72 62 61 | 74 69 6d 7d 0a 50 50 5f |in{verba|tim}.PP_|
|000021a0| 44 42 47 20 28 28 66 6f | 72 6d 61 74 2c 20 61 72 |DBG ((fo|rmat, ar|
|000021b0| 67 31 2c 20 61 72 67 32 | 20 2e 2e 2e 29 29 0a 63 |g1, arg2| ...)).c|
|000021c0| 68 61 72 20 20 20 2a 66 | 6f 72 6d 61 74 3b 0a 5c |har *f|ormat;.\|
|000021d0| 65 6e 64 7b 76 65 72 62 | 61 74 69 6d 7d 5c 65 6e |end{verb|atim}\en|
|000021e0| 64 7b 71 75 6f 74 65 7d | 0a 54 68 69 73 20 6d 61 |d{quote}|.This ma|
|000021f0| 63 72 6f 20 69 73 20 73 | 69 6d 69 6c 61 72 20 74 |cro is s|imilar t|
|00002200| 6f 20 74 68 65 20 5c 76 | 65 72 62 7c 50 50 5f 54 |o the \v|erb|PP_T|
|00002210| 52 41 43 45 7c 20 6d 61 | 63 72 6f 2c 20 65 78 63 |RACE| ma|cro, exc|
|00002220| 65 70 74 20 69 74 20 6c | 6f 67 73 20 61 74 0a 74 |ept it l|ogs at.t|
|00002230| 68 65 20 6c 65 76 65 6c | 20 6f 66 0a 5c 6c 69 6e |he level| of.\lin|
|00002240| 65 62 72 65 61 6b 0a 5c | 76 65 72 62 7c 4c 4c 4f |ebreak.\|verb|LLO|
|00002250| 47 5f 44 45 42 55 47 7c | 20 61 6e 64 20 77 69 6c |G_DEBUG|| and wil|
|00002260| 6c 20 6e 6f 74 20 65 78 | 70 61 6e 64 20 74 6f 20 |l not ex|pand to |
|00002270| 61 6e 79 74 68 69 6e 67 | 20 75 6e 6c 65 73 73 0a |anything| unless.|
|00002280| 5c 76 65 72 62 7c 50 50 | 5f 44 45 42 55 47 7c 20 |\verb|PP|_DEBUG| |
|00002290| 69 73 20 64 65 66 69 6e | 65 64 20 61 6e 64 20 68 |is defin|ed and h|
|000022a0| 61 73 20 61 20 76 61 6c | 75 65 20 67 72 65 61 74 |as a val|ue great|
|000022b0| 65 72 20 74 68 61 6e 20 | 31 20 28 75 73 75 61 6c |er than |1 (usual|
|000022c0| 6c 79 0a 5c 76 65 72 62 | 2b 50 50 5f 44 45 42 55 |ly.\verb|+PP_DEBU|
|000022d0| 47 5f 41 4c 4c 2b 5c 69 | 6e 64 65 78 7b 50 50 5c |G_ALL+\i|ndex{PP\|
|000022e0| 5f 44 45 42 55 47 5c 5f | 41 4c 4c 7d 29 2e 20 54 |_DEBUG\_|ALL}). T|
|000022f0| 68 69 73 20 6d 61 63 72 | 6f 0a 73 68 6f 75 6c 64 |his macr|o.should|
|00002300| 20 62 65 20 75 73 65 64 | 20 66 6f 72 20 76 65 72 | be used| for ver|
|00002310| 79 20 64 65 74 61 69 6c | 65 64 20 74 72 61 63 69 |y detail|ed traci|
|00002320| 6e 67 2c 20 6f 72 20 77 | 68 65 72 65 20 6c 61 72 |ng, or w|here lar|
|00002330| 67 65 20 61 6d 6f 75 6e | 74 73 20 6f 66 0a 6c 6f |ge amoun|ts of.lo|
|00002340| 67 67 69 6e 67 20 61 72 | 65 20 6c 69 6b 65 6c 79 |gging ar|e likely|
|00002350| 20 74 6f 20 62 65 20 67 | 65 6e 65 72 61 74 65 64 | to be g|enerated|
|00002360| 2e 0a 0a 5c 62 65 67 69 | 6e 7b 71 75 6f 74 65 7d |...\begi|n{quote}|
|00002370| 5c 69 6e 64 65 78 7b 50 | 50 5c 5f 50 44 55 7d 5c |\index{P|P\_PDU}\|
|00002380| 62 65 67 69 6e 7b 76 65 | 72 62 61 74 69 6d 7d 0a |begin{ve|rbatim}.|
|00002390| 50 50 5f 50 44 55 20 28 | 28 66 6e 78 2c 20 70 65 |PP_PDU (|(fnx, pe|
|000023a0| 2c 20 74 65 78 74 2c 20 | 72 77 29 29 0a 49 46 50 |, text, |rw)).IFP|
|000023b0| 20 20 20 20 66 6e 78 3b | 0a 50 45 20 20 20 20 20 | fnx;|.PE |
|000023c0| 70 65 3b 0a 63 68 61 72 | 20 20 20 2a 74 65 78 74 |pe;.char| *text|
|000023d0| 3b 0a 69 6e 74 20 20 20 | 20 72 77 3b 0a 5c 65 6e |;.int | rw;.\en|
|000023e0| 64 7b 76 65 72 62 61 74 | 69 6d 7d 5c 65 6e 64 7b |d{verbat|im}\end{|
|000023f0| 71 75 6f 74 65 7d 0a 54 | 68 69 73 20 6d 61 63 72 |quote}.T|his macr|
|00002400| 6f 20 69 73 20 66 6f 72 | 20 6c 6f 67 67 69 6e 67 |o is for| logging|
|00002410| 20 6f 66 20 41 53 4e 2e | 31 5c 69 6e 64 65 78 7b | of ASN.|1\index{|
|00002420| 41 53 4e 2e 31 7d 20 70 | 72 6f 74 6f 63 6f 6c 20 |ASN.1} p|rotocol |
|00002430| 64 61 74 61 20 75 6e 69 | 74 73 20 28 50 44 55 73 |data uni|ts (PDUs|
|00002440| 29 2e 0a 49 74 20 69 73 | 20 6f 6e 6c 79 20 63 6f |)..It is| only co|
|00002450| 6d 70 69 6c 65 64 20 69 | 6e 20 69 66 20 5c 76 65 |mpiled i|n if \ve|
|00002460| 72 62 7c 50 50 5f 44 45 | 42 55 47 7c 20 69 73 0a |rb|PP_DE|BUG| is.|
|00002470| 5c 76 65 72 62 2b 50 50 | 5f 44 45 42 55 47 5f 53 |\verb+PP|_DEBUG_S|
|00002480| 4f 4d 45 2b 5c 69 6e 64 | 65 78 7b 50 50 5c 5f 44 |OME+\ind|ex{PP\_D|
|00002490| 45 42 55 47 5c 5f 53 4f | 4d 45 7d 20 6f 72 20 67 |EBUG\_SO|ME} or g|
|000024a0| 72 65 61 74 65 72 2e 20 | 54 68 65 20 61 72 67 75 |reater. |The argu|
|000024b0| 6d 65 6e 74 73 0a 61 72 | 65 20 61 73 20 66 6f 6c |ments.ar|e as fol|
|000024c0| 6c 6f 77 73 3a 0a 5c 62 | 65 67 69 6e 7b 64 65 73 |lows:.\b|egin{des|
|000024d0| 63 72 69 62 65 7d 0a 5c | 69 74 65 6d 5b 5c 76 65 |cribe}.\|item[\ve|
|000024e0| 72 62 7c 66 6e 78 7c 3a | 5d 09 41 20 66 75 6e 63 |rb|fnx|:|].A func|
|000024f0| 74 69 6f 6e 20 74 6f 20 | 70 72 69 6e 74 20 6f 75 |tion to |print ou|
|00002500| 74 20 74 68 65 20 50 44 | 55 2e 20 54 68 69 73 20 |t the PD|U. This |
|00002510| 73 68 6f 75 6c 64 0a 62 | 65 20 61 20 66 75 6e 63 |should.b|e a func|
|00002520| 74 69 6f 6e 20 63 6f 6e | 73 74 72 75 63 74 65 64 |tion con|structed|
|00002530| 20 62 79 20 74 68 65 20 | 70 72 69 6e 74 65 72 20 | by the |printer |
|00002540| 6f 70 74 69 6f 6e 20 6f | 66 20 70 65 70 79 2e 0a |option o|f pepy..|
|00002550| 0a 5c 69 74 65 6d 5b 5c | 76 65 72 62 7c 70 65 7c |.\item[\|verb|pe||
|00002560| 3a 5d 09 54 68 65 20 70 | 72 65 73 65 6e 74 61 74 |:].The p|resentat|
|00002570| 69 6f 6e 20 65 6c 65 6d | 65 6e 74 20 74 6f 20 70 |ion elem|ent to p|
|00002580| 72 69 6e 74 20 6f 75 74 | 2e 0a 0a 5c 69 74 65 6d |rint out|...\item|
|00002590| 5b 5c 76 65 72 62 7c 73 | 74 72 7c 3a 5d 09 41 6e |[\verb|s|tr|:].An|
|000025a0| 20 65 78 70 6c 61 6e 61 | 74 6f 72 79 20 73 74 72 | explana|tory str|
|000025b0| 69 6e 67 2c 20 75 73 75 | 61 6c 6c 79 20 74 68 65 |ing, usu|ally the|
|000025c0| 20 6e 61 6d 65 20 6f 66 | 0a 74 68 65 20 50 44 55 | name of|.the PDU|
|000025d0| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 76 65 72 62 7c 72 |...\item|[\verb|r|
|000025e0| 77 7c 3a 5d 09 41 20 66 | 6c 61 67 20 69 6e 64 69 |w|:].A f|lag indi|
|000025f0| 63 61 74 69 6e 67 20 74 | 68 65 20 64 69 72 65 63 |cating t|he direc|
|00002600| 74 69 6f 6e 20 74 68 65 | 20 50 44 55 20 69 73 0a |tion the| PDU is.|
|00002610| 67 6f 69 6e 67 2e 20 53 | 65 74 20 74 6f 20 5c 76 |going. S|et to \v|
|00002620| 65 72 62 7c 50 44 55 5f | 57 52 49 54 45 7c 20 74 |erb|PDU_|WRITE| t|
|00002630| 6f 20 69 6e 64 69 63 61 | 74 65 20 74 68 65 20 70 |o indica|te the p|
|00002640| 64 75 20 69 73 20 62 65 | 69 6e 67 20 0a 77 72 69 |du is be|ing .wri|
|00002650| 74 74 65 6e 20 61 6e 64 | 20 5c 76 65 72 62 7c 50 |tten and| \verb|P|
|00002660| 44 55 5f 52 45 41 44 7c | 20 74 6f 20 73 68 6f 77 |DU_READ|| to show|
|00002670| 20 69 74 20 69 73 20 62 | 65 69 6e 67 20 72 65 61 | it is b|eing rea|
|00002680| 64 2e 0a 5c 65 6e 64 7b | 64 65 73 63 72 69 62 65 |d..\end{|describe|
|00002690| 7d 0a 4e 6f 6e 20 41 53 | 4e 2e 31 5c 69 6e 64 65 |}.Non AS|N.1\inde|
|000026a0| 78 7b 41 53 4e 2e 31 7d | 20 70 72 6f 74 6f 63 6f |x{ASN.1}| protoco|
|000026b0| 6c 20 65 78 63 68 61 6e | 67 65 73 20 63 61 6e 20 |l exchan|ges can |
|000026c0| 62 65 20 6c 6f 67 67 65 | 64 20 77 69 74 68 20 74 |be logge|d with t|
|000026d0| 68 65 0a 5c 76 65 72 62 | 7c 50 50 5f 4c 4f 47 7c |he.\verb||PP_LOG||
|000026e0| 20 6d 61 63 72 6f 20 61 | 74 20 74 68 65 20 0a 5c | macro a|t the .\|
|000026f0| 6c 69 6e 65 62 72 65 61 | 6b 0a 5c 76 65 72 62 7c |linebrea|k.\verb||
|00002700| 4c 4c 4f 47 5f 50 44 55 | 53 7c 20 6c 65 76 65 6c |LLOG_PDU|S| level|
|00002710| 2e 0a 0a 49 66 20 6f 74 | 68 65 72 20 6c 6f 67 67 |...If ot|her logg|
|00002720| 69 6e 67 20 63 61 6c 6c | 73 20 6e 6f 74 20 64 65 |ing call|s not de|
|00002730| 73 63 72 69 62 65 64 20 | 68 65 72 65 20 61 72 65 |scribed |here are|
|00002740| 20 6e 65 65 64 65 64 2c | 20 74 68 65 79 20 63 61 | needed,| they ca|
|00002750| 6e 20 62 65 0a 63 6f 6e | 73 74 72 75 63 74 65 64 |n be.con|structed|
|00002760| 20 66 72 6f 6d 20 74 68 | 65 20 6d 6f 72 65 20 67 | from th|e more g|
|00002770| 65 6e 65 72 61 6c 20 5c | 76 65 72 62 7c 53 4c 4f |eneral \|verb|SLO|
|00002780| 47 7c 5c 69 6e 64 65 78 | 7b 53 4c 4f 47 7d 20 6d |G|\index|{SLOG} m|
|00002790| 61 63 72 6f 0a 64 65 73 | 63 72 69 62 65 64 20 69 |acro.des|cribed i|
|000027a0| 6e 20 74 68 65 20 49 53 | 4f 44 45 20 6d 61 6e 75 |n the IS|ODE manu|
|000027b0| 61 6c 2e 20 55 73 65 20 | 6f 66 20 74 68 69 73 20 |al. Use |of this |
|000027c0| 66 65 61 74 75 72 65 20 | 69 73 20 64 69 73 63 6f |feature |is disco|
|000027d0| 75 72 61 67 65 64 2e 0a | 0a 5c 73 65 63 74 69 6f |uraged..|.\sectio|
|000027e0| 6e 20 7b 43 6f 64 65 20 | 4c 6f 63 61 74 69 6f 6e |n {Code |Location|
|000027f0| 7d 0a 0a 54 68 65 20 63 | 6f 64 65 20 74 6f 20 50 |}..The c|ode to P|
|00002800| 50 20 69 73 20 61 72 72 | 61 6e 67 65 64 20 69 6e |P is arr|anged in|
|00002810| 20 61 20 68 69 65 72 61 | 72 63 68 79 20 6f 66 20 | a hiera|rchy of |
|00002820| 64 69 72 65 63 74 6f 72 | 69 65 73 2e 20 54 68 69 |director|ies. Thi|
|00002830| 73 20 69 73 20 61 0a 62 | 72 69 65 66 20 74 6f 75 |s is a.b|rief tou|
|00002840| 72 20 61 72 6f 75 6e 64 | 20 74 68 65 20 73 74 72 |r around| the str|
|00002850| 75 63 74 75 72 65 2e 0a | 0a 5c 73 75 62 73 65 63 |ucture..|.\subsec|
|00002860| 74 69 6f 6e 7b 4c 69 62 | 72 61 72 79 20 43 6f 64 |tion{Lib|rary Cod|
|00002870| 65 7d 0a 0a 4d 75 63 68 | 20 6f 66 20 74 68 65 20 |e}..Much| of the |
|00002880| 50 50 20 73 79 73 74 65 | 6d 20 69 73 20 69 6e 20 |PP syste|m is in |
|00002890| 74 68 65 20 6c 69 62 72 | 61 72 79 20 63 6f 64 65 |the libr|ary code|
|000028a0| 2e 20 54 68 69 73 20 69 | 73 20 66 6f 75 6e 64 20 |. This i|s found |
|000028b0| 69 6e 0a 74 68 65 20 64 | 69 72 65 63 74 6f 72 79 |in.the d|irectory|
|000028c0| 20 5c 76 65 72 62 7c 4c | 69 62 2f 7c 5c 69 6e 64 | \verb|L|ib/|\ind|
|000028d0| 65 78 7b 4c 69 62 2f 7d | 20 75 6e 64 65 72 20 74 |ex{Lib/}| under t|
|000028e0| 68 65 20 74 6f 70 20 64 | 69 72 65 63 74 6f 72 79 |he top d|irectory|
|000028f0| 20 6f 66 20 74 68 65 20 | 50 50 0a 64 69 73 74 72 | of the |PP.distr|
|00002900| 69 62 75 74 69 6f 6e 2e | 20 20 54 68 65 20 6c 69 |ibution.| The li|
|00002910| 62 72 61 72 79 20 69 74 | 73 65 6c 66 20 69 73 20 |brary it|self is |
|00002920| 73 70 6c 69 74 20 69 6e | 74 6f 20 73 65 76 65 72 |split in|to sever|
|00002930| 61 6c 0a 73 75 62 64 69 | 72 65 63 74 6f 72 69 65 |al.subdi|rectorie|
|00002940| 73 2e 20 54 68 65 73 65 | 20 61 72 65 20 61 73 20 |s. These| are as |
|00002950| 66 6f 6c 6c 6f 77 73 3a | 0a 0a 5c 62 65 67 69 6e |follows:|..\begin|
|00002960| 7b 64 65 73 63 72 69 62 | 65 7d 0a 5c 69 74 65 6d |{describ|e}.\item|
|00002970| 5b 5c 76 65 72 62 7c 61 | 64 64 72 2f 7c 3a 5d 5c |[\verb|a|ddr/|:]\|
|00002980| 69 6e 64 65 78 7b 61 64 | 64 72 2f 7d 09 54 68 65 |index{ad|dr/}.The|
|00002990| 20 52 46 43 7e 38 32 32 | 20 61 64 64 72 65 73 73 | RFC~822| address|
|000029a0| 20 70 61 72 73 65 72 0a | 6c 69 62 72 61 72 79 2e | parser.|library.|
|000029b0| 20 54 68 69 73 0a 63 6f | 6e 74 61 69 6e 73 20 77 | This.co|ntains w|
|000029c0| 61 79 73 20 74 6f 20 6d | 61 6e 69 70 75 6c 61 74 |ays to m|anipulat|
|000029d0| 65 20 61 6e 64 20 70 72 | 6f 63 65 73 73 20 52 46 |e and pr|ocess RF|
|000029e0| 43 7e 38 32 32 20 61 64 | 64 72 65 73 73 65 73 2e |C~822 ad|dresses.|
|000029f0| 0a 0a 5c 69 74 65 6d 5b | 5c 76 65 72 62 7c 66 6f |..\item[|\verb|fo|
|00002a00| 72 6d 61 74 2f 7c 3a 5d | 5c 69 6e 64 65 78 7b 66 |rmat/|:]|\index{f|
|00002a10| 6f 72 6d 61 74 2f 7d 09 | 54 68 69 73 20 64 69 72 |ormat/}.|This dir|
|00002a20| 65 63 74 6f 72 79 20 63 | 6f 6e 74 61 69 6e 73 20 |ectory c|ontains |
|00002a30| 73 75 70 70 6f 72 74 20 | 72 6f 75 74 69 6e 65 73 |support |routines|
|00002a40| 20 66 6f 72 0a 66 6f 72 | 6d 61 74 74 69 6e 67 20 | for.for|matting |
|00002a50| 6d 65 73 73 61 67 65 73 | 2e 0a 0a 5c 69 74 65 6d |messages|...\item|
|00002a60| 5b 5c 76 65 72 62 7c 69 | 6f 2f 7c 3a 5d 5c 69 6e |[\verb|i|o/|:]\in|
|00002a70| 64 65 78 7b 69 6f 2f 7d | 09 54 68 69 73 20 64 69 |dex{io/}|.This di|
|00002a80| 72 65 63 74 6f 72 79 20 | 63 6f 6e 74 61 69 6e 73 |rectory |contains|
|00002a90| 20 6d 6f 73 74 20 6f 66 | 20 74 68 65 20 72 6f 75 | most of| the rou|
|00002aa0| 74 69 6e 65 73 0a 63 6f | 6e 63 65 72 6e 65 64 20 |tines.co|ncerned |
|00002ab0| 77 69 74 68 20 77 72 69 | 74 69 6e 67 20 6f 75 74 |with wri|ting out|
|00002ac0| 20 61 6e 64 20 72 65 61 | 64 69 6e 67 20 69 6e 20 | and rea|ding in |
|00002ad0| 73 74 72 75 63 74 75 72 | 65 73 2e 20 49 74 20 69 |structur|es. It i|
|00002ae0| 73 20 67 65 6e 65 72 61 | 6c 6c 79 0a 75 73 65 64 |s genera|lly.used|
|00002af0| 20 66 6f 72 20 72 65 61 | 64 69 6e 67 20 69 6e 20 | for rea|ding in |
|00002b00| 73 74 72 75 63 74 75 72 | 65 73 20 61 6e 64 20 77 |structur|es and w|
|00002b10| 72 69 74 69 6e 67 20 74 | 68 65 6d 20 6f 75 74 2e |riting t|hem out.|
|00002b20| 0a 0a 5c 69 74 65 6d 5b | 5c 76 65 72 62 7c 6f 72 |..\item[|\verb|or|
|00002b30| 2f 7c 3a 5d 5c 69 6e 64 | 65 78 7b 6f 72 2f 7d 09 |/|:]\ind|ex{or/}.|
|00002b40| 54 68 69 73 20 64 69 72 | 65 63 74 6f 72 79 20 68 |This dir|ectory h|
|00002b50| 61 73 20 61 20 73 65 74 | 20 6f 66 20 72 6f 75 74 |as a set| of rout|
|00002b60| 69 6e 65 73 20 66 6f 72 | 0a 6d 61 6e 69 70 75 6c |ines for|.manipul|
|00002b70| 61 74 69 6e 67 20 4f 2f | 52 20 61 64 64 72 65 73 |ating O/|R addres|
|00002b80| 73 65 73 2e 0a 0a 5c 69 | 74 65 6d 5b 5c 76 65 72 |ses...\i|tem[\ver|
|00002b90| 62 7c 70 61 72 73 65 2f | 7c 3a 5d 5c 69 6e 64 65 |b|parse/||:]\inde|
|00002ba0| 78 7b 70 61 72 73 65 2f | 7d 09 54 68 69 73 20 64 |x{parse/|}.This d|
|00002bb0| 69 72 65 63 74 6f 72 79 | 20 63 6f 6e 74 61 69 6e |irectory| contain|
|00002bc0| 73 20 74 68 65 20 63 6f | 64 65 20 74 6f 20 64 6f |s the co|de to do|
|00002bd0| 20 74 68 65 20 67 65 6e | 65 72 69 63 0a 70 61 72 | the gen|eric.par|
|00002be0| 73 69 6e 67 20 6f 66 20 | 61 64 64 72 65 73 73 65 |sing of |addresse|
|00002bf0| 73 2e 20 49 74 20 63 6f | 6e 74 61 69 6e 73 20 74 |s. It co|ntains t|
|00002c00| 68 65 20 67 65 6e 65 72 | 61 6c 20 69 6e 74 65 72 |he gener|al inter|
|00002c10| 66 61 63 65 20 74 6f 20 | 58 2e 34 30 30 20 61 6e |face to |X.400 an|
|00002c20| 64 0a 52 46 43 7e 38 32 | 32 20 61 64 64 72 65 73 |d.RFC~82|2 addres|
|00002c30| 73 65 73 2e 0a 0a 5c 69 | 74 65 6d 5b 5c 76 65 72 |ses...\i|tem[\ver|
|00002c40| 62 7c 70 70 2f 7c 3a 5d | 5c 69 6e 64 65 78 7b 70 |b|pp/|:]|\index{p|
|00002c50| 70 2f 7d 09 54 68 69 73 | 20 64 69 72 65 63 74 6f |p/}.This| directo|
|00002c60| 72 79 20 63 6f 6e 74 61 | 69 6e 73 20 6d 61 6e 79 |ry conta|ins many|
|00002c70| 20 6f 66 20 74 68 65 20 | 62 61 73 69 63 20 50 50 | of the |basic PP|
|00002c80| 0a 73 70 65 63 69 66 69 | 63 20 72 6f 75 74 69 6e |.specifi|c routin|
|00002c90| 65 73 20 73 75 63 68 20 | 61 73 20 6d 61 6e 69 70 |es such |as manip|
|00002ca0| 75 6c 61 74 69 6f 6e 20 | 6f 66 20 73 74 72 75 63 |ulation |of struc|
|00002cb0| 74 75 72 65 73 2c 20 50 | 50 20 73 74 72 75 63 74 |tures, P|P struct|
|00002cc0| 75 72 65 73 2c 20 61 6e | 64 0a 74 68 65 20 66 6c |ures, an|d.the fl|
|00002cd0| 61 74 74 65 6e 69 6e 67 | 20 61 6e 64 20 75 6e 66 |attening| and unf|
|00002ce0| 6c 61 74 74 65 6e 69 6e | 67 20 6f 66 20 74 68 65 |lattenin|g of the|
|00002cf0| 73 65 20 73 74 72 75 63 | 74 75 72 65 73 2e 0a 0a |se struc|tures...|
|00002d00| 5c 69 74 65 6d 5b 5c 76 | 65 72 62 7c 71 6d 67 72 |\item[\v|erb|qmgr|
|00002d10| 2f 7c 3a 5d 5c 69 6e 64 | 65 78 7b 71 6d 67 72 2f |/|:]\ind|ex{qmgr/|
|00002d20| 7d 09 54 68 69 73 20 64 | 69 72 65 63 74 6f 72 79 |}.This d|irectory|
|00002d30| 20 63 6f 6e 74 61 69 6e | 73 20 74 68 65 20 63 6f | contain|s the co|
|00002d40| 64 65 20 72 65 71 75 69 | 72 65 64 20 74 6f 0a 69 |de requi|red to.i|
|00002d50| 6e 74 65 72 66 61 63 65 | 20 77 69 74 68 20 74 68 |nterface| with th|
|00002d60| 65 20 51 4d 47 52 20 70 | 72 6f 63 65 73 73 2e 0a |e QMGR p|rocess..|
|00002d70| 0a 5c 69 74 65 6d 5b 5c | 76 65 72 62 7c 74 61 62 |.\item[\|verb|tab|
|00002d80| 6c 65 2f 7c 3a 5d 5c 69 | 6e 64 65 78 7b 74 61 62 |le/|:]\i|ndex{tab|
|00002d90| 6c 65 2f 7d 09 54 68 69 | 73 20 64 69 72 65 63 74 |le/}.Thi|s direct|
|00002da0| 6f 72 79 20 63 6f 6e 74 | 61 69 6e 73 20 72 6f 75 |ory cont|ains rou|
|00002db0| 74 69 6e 65 73 20 66 6f | 72 20 61 63 63 65 73 73 |tines fo|r access|
|00002dc0| 69 6e 67 0a 74 68 65 20 | 64 61 74 61 62 61 73 65 |ing.the |database|
|00002dd0| 73 20 75 73 65 64 20 62 | 79 20 50 50 20 66 6f 72 |s used b|y PP for|
|00002de0| 20 72 6f 75 74 69 6e 67 | 2c 20 61 6c 69 61 73 65 | routing|, aliase|
|00002df0| 73 20 61 6e 64 20 74 68 | 65 20 6c 69 6b 65 2e 0a |s and th|e like..|
|00002e00| 0a 5c 69 74 65 6d 5b 5c | 76 65 72 62 7c 74 61 69 |.\item[\|verb|tai|
|00002e10| 2f 7c 3a 5d 5c 69 6e 64 | 65 78 7b 74 61 69 2f 7d |/|:]\ind|ex{tai/}|
|00002e20| 09 54 68 69 73 20 63 6f | 6e 74 61 69 6e 73 20 74 |.This co|ntains t|
|00002e30| 68 65 20 72 6f 75 74 69 | 6e 65 73 20 72 65 73 70 |he routi|nes resp|
|00002e40| 6f 6e 73 69 62 6c 65 20 | 66 6f 72 0a 72 65 61 64 |onsible |for.read|
|00002e50| 69 6e 67 20 61 6e 64 20 | 70 61 72 73 69 6e 67 20 |ing and |parsing |
|00002e60| 74 68 65 20 5c 66 69 6c | 65 7b 74 61 69 6c 6f 72 |the \fil|e{tailor|
|00002e70| 7d 20 66 69 6c 65 2e 0a | 0a 5c 69 74 65 6d 5b 5c |} file..|.\item[\|
|00002e80| 76 65 72 62 7c 75 74 69 | 6c 2f 7c 3a 5d 5c 69 6e |verb|uti|l/|:]\in|
|00002e90| 64 65 78 7b 75 74 69 6c | 2f 7d 09 54 68 69 73 20 |dex{util|/}.This |
|00002ea0| 64 69 72 65 63 74 6f 72 | 79 20 63 6f 6e 74 61 69 |director|y contai|
|00002eb0| 6e 73 20 73 6f 6d 65 0a | 67 65 6e 65 72 61 6c 6c |ns some.|generall|
|00002ec0| 79 20 75 73 65 66 75 6c | 20 63 6f 6d 6d 6f 6e 20 |y useful| common |
|00002ed0| 70 72 6f 63 65 64 75 72 | 65 73 2e 0a 0a 5c 69 74 |procedur|es...\it|
|00002ee0| 65 6d 5b 5c 76 65 72 62 | 7c 78 34 30 30 2f 7c 3a |em[\verb||x400/|:|
|00002ef0| 5d 5c 69 6e 64 65 78 7b | 78 34 30 30 2f 7d 09 54 |]\index{|x400/}.T|
|00002f00| 68 69 73 20 64 69 72 65 | 63 74 6f 72 79 20 63 6f |his dire|ctory co|
|00002f10| 6e 74 61 69 6e 73 0a 73 | 75 70 70 6f 72 74 20 72 |ntains.s|upport r|
|00002f20| 6f 75 74 69 6e 65 73 20 | 66 6f 72 20 58 2e 34 30 |outines |for X.40|
|00002f30| 30 20 68 61 6e 64 6c 69 | 6e 67 2e 0a 5c 65 6e 64 |0 handli|ng..\end|
|00002f40| 7b 64 65 73 63 72 69 62 | 65 7d 0a 0a 5c 73 75 62 |{describ|e}..\sub|
|00002f50| 73 65 63 74 69 6f 6e 7b | 43 6f 72 65 20 50 72 6f |section{|Core Pro|
|00002f60| 67 72 61 6d 73 7d 0a 0a | 54 68 65 20 6e 65 78 74 |grams}..|The next|
|00002f70| 20 6d 61 6a 6f 72 20 64 | 69 72 65 63 74 6f 72 79 | major d|irectory|
|00002f80| 20 74 6f 20 62 65 20 63 | 6f 6e 73 69 64 65 72 65 | to be c|onsidere|
|00002f90| 64 20 69 73 20 74 68 65 | 0a 5c 76 65 72 62 7c 53 |d is the|.\verb|S|
|00002fa0| 72 63 2f 7c 5c 69 6e 64 | 65 78 7b 53 72 63 2f 7d |rc/|\ind|ex{Src/}|
|00002fb0| 20 64 69 72 65 63 74 6f | 72 79 2e 20 54 68 69 73 | directo|ry. This|
|00002fc0| 20 63 6f 6e 74 61 69 6e | 73 20 74 68 65 20 63 6f | contain|s the co|
|00002fd0| 72 65 20 70 72 6f 67 72 | 61 6d 73 0a 72 65 71 75 |re progr|ams.requ|
|00002fe0| 69 72 65 64 20 62 79 20 | 50 50 2e 20 54 68 65 73 |ired by |PP. Thes|
|00002ff0| 65 20 61 72 65 3a 0a 5c | 62 65 67 69 6e 7b 64 65 |e are:.\|begin{de|
|00003000| 73 63 72 69 62 65 7d 0a | 5c 69 74 65 6d 5b 5c 76 |scribe}.|\item[\v|
|00003010| 65 72 62 7c 4d 54 41 63 | 6f 6e 73 6f 6c 65 2f 7c |erb|MTAc|onsole/||
|00003020| 3a 5d 5c 69 6e 64 65 78 | 7b 4d 54 41 63 6f 6e 73 |:]\index|{MTAcons|
|00003030| 6f 6c 65 2f 7d 09 54 68 | 69 73 20 69 73 20 74 68 |ole/}.Th|is is th|
|00003040| 65 20 73 6f 75 72 63 65 | 0a 63 6f 64 65 20 66 6f |e source|.code fo|
|00003050| 72 20 74 68 65 20 58 2d | 62 61 73 65 64 20 4d 54 |r the X-|based MT|
|00003060| 41 20 63 6f 6e 73 6f 6c | 65 20 70 72 6f 67 72 61 |A consol|e progra|
|00003070| 6d 2e 20 49 74 20 6d 6f | 6e 69 74 6f 72 73 20 74 |m. It mo|nitors t|
|00003080| 68 65 20 6f 76 65 72 61 | 6c 6c 0a 72 75 6e 6e 69 |he overa|ll.runni|
|00003090| 6e 67 20 6f 66 20 50 50 | 2e 0a 0a 5c 69 74 65 6d |ng of PP|...\item|
|000030a0| 5b 5c 76 65 72 62 7c 4c | 49 4e 45 63 6f 6e 73 6f |[\verb|L|INEconso|
|000030b0| 6c 65 2f 7c 3a 5d 5c 69 | 6e 64 65 78 7b 4c 49 4e |le/|:]\i|ndex{LIN|
|000030c0| 45 63 6f 6e 73 6f 6c 65 | 7d 20 54 68 65 20 73 6f |Econsole|} The so|
|000030d0| 75 72 63 65 20 66 6f 72 | 20 61 20 6c 69 6e 65 0a |urce for| a line.|
|000030e0| 62 61 73 65 64 20 63 6f | 6e 73 6f 6c 65 20 70 72 |based co|nsole pr|
|000030f0| 6f 67 72 61 6d 2e 0a 0a | 5c 69 74 65 6d 5b 5c 76 |ogram...|\item[\v|
|00003100| 65 72 62 7c 6c 63 6f 6e | 73 6f 6c 65 2f 7c 3a 5d |erb|lcon|sole/|:]|
|00003110| 5c 69 6e 64 65 78 7b 6c | 63 6f 6e 73 6f 6c 65 7d |\index{l|console}|
|00003120| 20 54 68 65 20 73 6f 75 | 72 63 65 20 66 6f 72 20 | The sou|rce for |
|00003130| 61 6e 20 61 6c 74 65 72 | 6e 61 74 69 76 65 0a 6c |an alter|native.l|
|00003140| 69 6e 65 20 62 61 73 65 | 64 20 63 6f 6e 73 6f 6c |ine base|d consol|
|00003150| 65 2e 0a 0a 5c 69 74 65 | 6d 5b 5c 76 65 72 62 7c |e...\ite|m[\verb||
|00003160| 73 75 62 6d 69 74 2f 7c | 3a 5d 5c 69 6e 64 65 78 |submit/||:]\index|
|00003170| 7b 73 75 62 6d 69 74 2f | 7d 09 54 68 69 73 20 69 |{submit/|}.This i|
|00003180| 73 20 74 68 65 20 73 6f | 75 72 63 65 20 66 6f 72 |s the so|urce for|
|00003190| 20 74 68 65 0a 73 75 62 | 6d 69 73 73 69 6f 6e 20 | the.sub|mission |
|000031a0| 70 72 6f 63 65 73 73 2e | 20 41 6c 6c 20 6d 65 73 |process.| All mes|
|000031b0| 73 61 67 65 73 20 65 6e | 74 65 72 69 6e 67 20 74 |sages en|tering t|
|000031c0| 68 65 20 71 75 65 75 65 | 20 67 6f 20 74 68 72 6f |he queue| go thro|
|000031d0| 75 67 68 20 74 68 69 73 | 20 70 72 6f 63 65 73 73 |ugh this| process|
|000031e0| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 76 65 72 62 7c 71 |...\item|[\verb|q|
|000031f0| 6d 67 72 2f 7c 3a 5d 5c | 69 6e 64 65 78 7b 71 6d |mgr/|:]\|index{qm|
|00003200| 67 72 2f 7d 09 54 68 69 | 73 20 69 73 20 74 68 65 |gr/}.Thi|s is the|
|00003210| 20 73 6f 75 72 63 65 20 | 66 6f 72 20 74 68 65 0a | source |for the.|
|00003220| 51 4d 47 52 20 70 72 6f | 63 65 73 73 2e 0a 0a 5c |QMGR pro|cess...\|
|00003230| 69 74 65 6d 5b 5c 76 65 | 72 62 7c 70 70 74 73 61 |item[\ve|rb|pptsa|
|00003240| 70 64 2f 7c 3a 5d 5c 69 | 6e 64 65 78 7b 70 70 74 |pd/|:]\i|ndex{ppt|
|00003250| 73 61 70 64 2f 7d 09 54 | 68 69 73 20 69 73 20 74 |sapd/}.T|his is t|
|00003260| 68 65 20 73 6f 75 72 63 | 65 20 66 6f 72 20 74 68 |he sourc|e for th|
|00003270| 65 20 70 70 0a 74 73 61 | 70 20 64 61 65 6d 6f 6e |e pp.tsa|p daemon|
|00003280| 2e 20 54 68 69 73 20 69 | 73 20 74 68 65 20 70 72 |. This i|s the pr|
|00003290| 6f 63 65 73 73 20 74 68 | 61 74 20 72 75 6e 73 20 |ocess th|at runs |
|000032a0| 74 68 65 20 63 68 61 6e | 6e 65 6c 73 20 69 6e 76 |the chan|nels inv|
|000032b0| 6f 6b 65 64 20 62 79 20 | 74 68 65 0a 71 75 65 75 |oked by |the.queu|
|000032c0| 65 20 6d 61 6e 61 67 65 | 72 2e 0a 0a 5c 65 6e 64 |e manage|r...\end|
|000032d0| 7b 64 65 73 63 72 69 62 | 65 7d 0a 0a 5c 73 75 62 |{describ|e}..\sub|
|000032e0| 73 65 63 74 69 6f 6e 7b | 4f 74 68 65 72 20 44 69 |section{|Other Di|
|000032f0| 72 65 63 74 6f 72 69 65 | 73 7d 0a 54 68 65 20 61 |rectorie|s}.The a|
|00003300| 72 65 20 74 68 65 20 66 | 6f 6c 6c 6f 77 69 6e 67 |re the f|ollowing|
|00003310| 20 6f 74 68 65 72 20 64 | 69 72 65 63 74 6f 72 69 | other d|irectori|
|00003320| 65 73 20 77 68 69 63 68 | 20 68 61 76 65 20 73 6f |es which| have so|
|00003330| 6d 65 20 73 69 67 6e 69 | 66 69 63 61 6e 63 65 2e |me signi|ficance.|
|00003340| 0a 0a 5c 62 65 67 69 6e | 7b 64 65 73 63 72 69 62 |..\begin|{describ|
|00003350| 65 7d 0a 5c 69 74 65 6d | 5b 5c 76 65 72 62 7c 68 |e}.\item|[\verb|h|
|00003360| 2f 7c 3a 5d 5c 69 6e 64 | 65 78 7b 68 2f 7d 09 43 |/|:]\ind|ex{h/}.C|
|00003370| 6f 6e 74 61 69 6e 73 20 | 61 6c 6c 20 74 68 65 20 |ontains |all the |
|00003380| 70 75 62 6c 69 63 20 68 | 65 61 64 65 72 20 66 69 |public h|eader fi|
|00003390| 6c 65 73 20 75 73 65 64 | 20 69 6e 0a 74 68 65 20 |les used| in.the |
|000033a0| 50 50 20 73 79 73 74 65 | 6d 2e 0a 0a 5c 69 74 65 |PP syste|m...\ite|
|000033b0| 6d 5b 5c 76 65 72 62 7c | 64 6f 63 2f 7c 3a 5d 5c |m[\verb||doc/|:]\|
|000033c0| 69 6e 64 65 78 7b 64 6f | 63 2f 7d 09 43 6f 6e 74 |index{do|c/}.Cont|
|000033d0| 61 69 6e 73 20 74 68 65 | 20 64 6f 63 75 6d 65 6e |ains the| documen|
|000033e0| 74 61 74 69 6f 6e 20 6f | 6e 20 50 50 2e 0a 0a 5c |tation o|n PP...\|
|000033f0| 69 74 65 6d 5b 5c 76 65 | 72 62 7c 6d 61 6e 2f 7c |item[\ve|rb|man/||
|00003400| 3a 5d 5c 69 6e 64 65 78 | 7b 6d 61 6e 2f 7d 09 43 |:]\index|{man/}.C|
|00003410| 6f 6e 74 61 69 6e 73 20 | 6d 61 6e 75 61 6c 20 70 |ontains |manual p|
|00003420| 61 67 65 73 20 6f 6e 20 | 74 68 65 20 50 50 20 70 |ages on |the PP p|
|00003430| 72 6f 67 72 61 6d 73 2e | 0a 0a 5c 69 74 65 6d 5b |rograms.|..\item[|
|00003440| 5c 76 65 72 62 7c 55 69 | 70 2f 7c 3a 5d 5c 69 6e |\verb|Ui|p/|:]\in|
|00003450| 64 65 78 7b 55 69 70 2f | 7d 09 43 6f 6e 74 61 69 |dex{Uip/|}.Contai|
|00003460| 6e 73 20 73 6f 6d 65 20 | 75 73 65 72 20 69 6e 74 |ns some |user int|
|00003470| 65 72 66 61 63 65 20 70 | 72 6f 67 72 61 6d 73 20 |erface p|rograms |
|00003480| 66 6f 72 0a 73 75 62 6d | 69 74 74 69 6e 67 20 6d |for.subm|itting m|
|00003490| 65 73 73 61 67 65 73 20 | 74 6f 20 50 50 2e 0a 0a |essages |to PP...|
|000034a0| 5c 69 74 65 6d 5b 5c 76 | 65 72 62 7c 54 6f 6f 6c |\item[\v|erb|Tool|
|000034b0| 73 2f 7c 3a 5d 5c 69 6e | 64 65 78 7b 54 6f 6f 6c |s/|:]\in|dex{Tool|
|000034c0| 73 2f 7d 20 20 43 6f 6e | 74 61 69 6e 73 20 73 65 |s/} Con|tains se|
|000034d0| 76 65 72 61 6c 20 70 72 | 6f 67 72 61 6d 73 0a 75 |veral pr|ograms.u|
|000034e0| 73 65 66 75 6c 20 66 6f | 72 20 62 75 69 6c 64 69 |seful fo|r buildi|
|000034f0| 6e 67 20 75 70 20 70 61 | 72 74 73 20 6f 66 20 74 |ng up pa|rts of t|
|00003500| 68 65 20 50 50 20 73 79 | 73 74 65 6d 20 6f 72 20 |he PP sy|stem or |
|00003510| 76 65 72 69 66 79 69 6e | 67 20 69 74 2e 0a 0a 5c |verifyin|g it...\|
|00003520| 69 74 65 6d 5b 5c 76 65 | 72 62 7c 43 68 61 6e 73 |item[\ve|rb|Chans|
|00003530| 2f 7c 3a 5d 5c 69 6e 64 | 65 78 7b 43 68 61 6e 73 |/|:]\ind|ex{Chans|
|00003540| 2f 7d 20 54 68 65 20 63 | 68 61 6e 6e 65 6c 20 70 |/} The c|hannel p|
|00003550| 72 6f 67 72 61 6d 73 20 | 63 61 6e 20 61 6c 6c 20 |rograms |can all |
|00003560| 62 65 0a 66 6f 75 6e 64 | 20 75 6e 64 65 72 20 74 |be.found| under t|
|00003570| 68 65 20 64 69 72 65 63 | 74 6f 72 79 20 5c 76 65 |he direc|tory \ve|
|00003580| 72 62 7c 43 68 61 6e 73 | 2f 7c 2e 0a 5c 65 6e 64 |rb|Chans|/|..\end|
|00003590| 7b 64 65 73 63 72 69 62 | 65 7d 0a |{describ|e}. |
+--------+-------------------------+-------------------------+--------+--------+
